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A new generation of Color Computer products 



V-Term Terminal Emulator am w 51^ coc* m omy) improved! 

V-Temi U one of the most ndvanccd terminal prograaas for the CoCo HI evert!! 

FEATURES: VT-lOO, VT-52, Vldtex{toc!udes RLE graphic* display), and standard CRT emulation*. Full use of 512K, 
80X28 text or graphics characters, Windows & Mu!tl-tasking{Disk Basic!), RAMDISK like buffer, X modem , Xmodem- 
CRC, Ymodew, Xon/Xoff. Monochrome monitor support Capture buffer, Snapshot, Conference mode, Serfal/RS- 
232/DCModem Pak. 35/40/80 Tracks, Over 56 pages of docs! Disk $39.95 Ver 02.00.00 upgrade . $6.95 



MAX- 1 0 (CoCo III only) The dazzling Word Processor and document creator for the CoCo Dtt 
- MAX- 10 is the perfect partner for CoCo MAX III! Mix graphics and text to get great looking newsletters, 
flyers, term papers, ect... MAX-10 .... 179.95 CoCo Max 111 .... $74.95 or buy BOTH for 1139.95 and savel 



MAXSOUND <t28k or 5i2k coco ni only) See June '88 review 



Turn your CoCo U1 into a REAL digital audio sampler with HIGH quality audio reproduction. Easily add exotic effects, 
ECHO, stuttering, speed shifting, sequencing, and reverse audio to BASIC or ML programs or GRAPHICS! Now 
includes Data Compression. Imagine recording any Voice. Music, or Sound effect and being able to use these DIGITAL 
recordings in your own programs! 3 disk sides Includes: INTERFACT/B1N - ML driver for sound effects. G&M/BAS - 
Adds sound effects to Graphics. SHOWTIME and DEMO disks. SCOPE/BAS - Turns CRT into a Digital Oscilloscope 
to look at MAXSOUND waveforms, CALL TO HEAR 'OVER THE PHONE* DEMO ♦ 159,95 



MAXSOUND SOUNDTRACKS W / GRAPHICS (MAXSOUND program NOT req'd) Call for Titles .... $5.95 



GRAPHICS-25 (5121c CoCo III only) Great with MAXSOUND and/or CoCo Max HI! 

Utilize the FULL 512k memory range of your CoCo HI from BASIC lor graphics! Create up to 25 ONBOARD HIRES 
SCREENS! Six new BASIC commands allow instant display switching while secretly drawing other screens. Save and 
load 'screens to and from disk. Copy one screen to another. Fast Graphics action. Smooth animation, and 100% 
Machine Language code. Requires DECB 1.0, DECB 1.1, or FKEYS III, Complete with documentation. Disk $24,95 



MULTI-LABEL ffl (CoCo m only) See July '87 Tevlew. An easy to use, versatile label creating program 
including many new CoCo III features. Print multiple fonts on each label! Disk $16.95 



FKEYS HI (CoCo l/D/IU) See April '87 review. A user friendly, user programmable function key utility that 
creates up to 20 function keys. Includes an EDITOR. DOS mods, DISABLE, and It's EPROMablel. Disk $19.95 

SDCDRIVE (CoCo 1/11/ 111) This machine language utility modifies DECB t.0, 1.1, FKEYS IH. or ADOS to 
allow the use of 3 double-sided drives (or 2 D/S drives and J&R's RAM DISKS) as 6 S/S drives. Disk . $16.95 



AUTO DIM (CoCo III only) See Jan. '88 review. This hardware device protects your monitor, or TV from 
IMAGE BURN after a few minutes of Inactivity from your keyboard. Illustrated and easy to Install. Hdwe $29.95 

MPI-COCO IxxJdng Hate (CoCo HI only) Now 2 styles Protects your CoCo in and MulH Pak 
Interface from destroying each other! Please specify MPI number 26-3024 or 26-3124 when ordering! Only $9.95 



In Quest of the Star Lord (CoCo III only) Enjoy the mixture of science and fantasy 

as you quest for the Phoenix CroBBbow, the only thing that can save you in the post-holocaust world. 4 Disk 
Sides of animated graphics adventure! Outstanding 320x200 graphics! Disk .. $34.95 Hint Sheet ...... $3.95 



Kung-Fu Dude (CoCo 1/fl/IU) See Feb. '88 review. A Kung-Fu program for the CoCo. Destroy opponents 
and evade obstacles as you grow even closer to your ultimate objective! Disk $24.95 

FYRAMDC (CoCo HI only) See Dec. '87 review. Brilliant colors, sharp graphics, and hot action! Disk .. $19.95 



AD&D Character's Companion (CoCo 1/B/TD) Great timessvtng 

5lity helps create compatible AD&D characters. Includes dice rotting routine, pick ability, race & dais. Bu 
from the Players Handbook, magic Items & spell materials. Save, load, and print character Info. 3 Disk sides $24, 



White Fire Of Eternity (CoCo l/n/in) See Dec. '86 review. A great graphics adventure! Disk.. $19.95 
CHAMPION (CoCo 1/U/1II) See May '87 review. Become a superhero fa this action adventure! Disk.. $19.95 



Toll Free 1^800-441-GIME Order line 



Technical assistance: 7pm to 9pm GIMMESOFT Add $3.00 for shipping and handling 

Orders: 9am to 9pm Eastern time P.O. Box 421 Add $2.50 for COD (USA only) 

On-line orders and up to date Perry Hall, MD 21128 MD residents add 5% sales tax 

information; Delphi's CoCo Slg 301-256-7558 or 301-256-2953 V1SA/MC/ Check/Money Order/ COD 
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As many of you know CoCo Clipboard 
Magazine Lb now a full time operation. As of 
July 22nd this magazine is no longer the part 
time job it has been for the last year. If you 
had asked me a year ago if we could have made 
our living from a Color Computer magazine 
after just one year of publication, I don't 
think I could have answered "Yes". But with 
your won- derful support in subscriptions, our 
ad- vertisers support and the Lord's blessing 
it has happened. Our heartfelt thanks to you 
al 1 . 

Over the past year we've tried a number 
of page layouts and column sizes. We've tried 
several different approaches to type size, 
spacing and fonts. We'd love to be fully type- 
set, but that's a while off yet and while 
we're waiting I'd appreciate your comments on 
thi3 issues column presentation. We've re- 
turned to a 10 pitch, but maintained the same 
column size as the last issue, however we've 
eliminated the extra spaces between para- 
graphs. After reviewing what 99% of what other 
magazines do from paragraph to paragraph we 
saw they rarely used extra spaces. So we took 
them out. In their place we went back to 6 
lines per inch from the 8 per inch in the last 
issue. Your comments on these areas would be 
appreciated. 




1. Regular Computer Products 

2. Educational Software 

3. Express Order Catalog 

The computer catalog does list a number of 
new games for the CoCo. Some are ROM Paks , one 
is disk, and they range from CoCo 1, 2, and 3 
compatible to CoCo 3 only. No new hardware was 
announced. We had hoped to see a new RS232 
Pak, new Multi-Pak, new 3.5 drives and perhaps 
a new monochrome RGB monitor for the CoCo. But 
we didn't and so what I said last issue now 
goes double: WRITE! WRITE! WRITE! Please give 
Tandy your thoughts, let them know you'd like 
updates to software, new hardware, new produc- 
tivity software, and just about anything else 
you can think of. We have noticed in countleas 
phone calls and conversations that there is a 
growing ground swell of disappointment in 
Tandy's lack of serious support for the CoCo. 
4 



Oh sure, the support ia better than what 
they're giving to Model 4 and 6000 users of 
late because those "business" machines are 
being overshadowed by the clone units. The 
CoCo remains as Tandy's only non-PC machine 
capable of real multitasking, multiuser pro- 
ductivity that. doesn't require a small loan 
from the Federal Reserve to buy! It*B a real 
shame that they have chosen to not support the 
non-PC market. I'm sure Apple and Atari and 
Commodore are breathing a LOT easier because 
Tandy has not taken the 68xxx CPU seriously. 
The CoCo is their only continuing 68xx entry 
and could be a real money maker for them in 
the A/A/C market area if it was only treated 
with more respect. Up the clock speed if pos- 
sible, drop in a real RS232 and parallel 
ports, get OS9 Level II and MultiVue fixed or 
get rid of them, get a replacement for the MPI 
and a plug in hard drive syBtem based on any 
of the several that are on the market today. 
Better yet, make them all available with the 
proper drivers, programs etc. and let the 
buyer decide, and let's get RAM up to 640K! I 
think that the folks in Ft. Worth are afraid 
that they will be drawing away business from 
their PC market. But in fact they are not 
gaining anything by maintaining this policy 
because there are thousands of people who 
can't stand MS-DOS, OS/2 or the 8086, 286 or 
386 CPU's and will never set foot in a Radio 
Shack or Computer Center (with mega $$$ in 
their pockets). And why? Because they can't 
find support from America's largest electronic 
retailer. Those dollars aren't competitve to 
the PC market, they are complimentary. 

In fact it could have been a cool $72 
million complimentary dollars. That number by 
the way comes from a survey conducted by the 
editors of Macintosh Business Review Magazine 
(copyright by VNU Publications September 1988 
vol. 1 issue 2). They conducted a survey of 
the top 50 companies in the U.S.A. to see how 
many Mac's were being used by these companies. 
I totaled the numbers and came up with 72,000 
units. If you figure a company will spend at 
least $1000.00 per Mac installation, that's a 
lot of dollars not in the till. I'm not saying 
Tandy should start selling Maclnstosh 
computers, or Atari ST's or Amiga's - they 
should be giving equal billing to their only 
low cost non PC machine - the CoCo, By giving 
the CoCo a little more credit and hype Radio 
Shack doesn't lose out on dollars that will 
NEVER go to a PC machine. The CoCo can 
provide, with a few i mprovementswhat the non 
PC customer really wants - the environment 
Continod On 10 




CoCo 'N Amateur Radio 



Mike Dooley KE4PC 



Editors No to: This installment of Mike's 
column tells you how to hook up your CoCo to a 
Ham Radio. If you have the least doubt as to 
whether or not you can safely perform this 
procedure , please get the help of a person ex- 
perienced in electronics , 

Well, it looks as if we've made our first 
anniversary! That's one whole year of the CoCo 
Clipboard and we've only just begun to scratch 
the surface of CoCo ' s and Amateur Radio. 

Recently I came across nn interesting 
Public Domain program for the CoCo . It's 
written by N6LQV. The program allows the 
transmission and reception of Radio Teletype 
using the cassette port of the CoCo. 

There is an earlier version of this 
program by the same author that only allowed 
operation at 60 WPH (words per minute or 45 
baud). This newer version has many enhance- 
ments. These include the ability to operate at 
60, 67, 75 and 100 WPM. Direct disk access is 
allowed and there is a Transmit and Receive 
buffer. 

The software comes as two programs. The 
first is called MAKERTTY . HAS . The purpose of 
this program is to generate the machine lan- 
guage program RTTY. BIN. ATter RTTY. BIN has 
been produced and saved to disk the second 
program, RTTY.BAS, is used to load and run it. 



When the program finishes loading a menu 
comes up on the screen. This menu has seven 
selections and looks like this: 

**** RTTY TERMINAL PROGRAM **** 

BYTES 

SAVE RECEIVE BUFFER 0 
PRINT RECEIVE BUFFER 
SHOW RECEIVE BUFFER 
- >RECEI VE/TRANSMIT 

LOAD TRANSMIT BUFFER 0 
CLKAR ALL BUFFERS 
BAUD RATE: 4 5 WPM: 60 

DURING TRANSMIT/RECEIVE: 
BREAK: RETURN TO THIS MENU 
CLEAR: TOGGLE RECEIVE/TRANSMIT 
RIGHT ARROW: TRANSMIT BUFFER 
There is an arrow to the left of 
RECEIVE/TRANSMIT. The arrow Is moved using the 
UP and down arrow keys on your COCO keyboard. 



Once the arrow is pointing at the desired 
selection you simply press the ENTER key. 

Before I discuss each selection let's 
look at the Buffers. There is a Transmit 
Buffer and a Receive Buffer. If you are in the 
RECEIVE/TRANSMIT mode anything you receive 
(see on the screen) is automatically put into 
the Receive Buffer. The Transmit Buffer is 
loaded from a disk with information such as 
your name, location, etc. and can be trans- 
mitted by pressing the RIGHT ARROW key on the 
keyboard . 

Notice the column to the right of the 
menu with the word BYTES at the top? The '0's 
below the word BYTES tell how much Information 
is stored in each buffer. With this background 
information let's proceed. 

SAVE RECEIVE BUFFER - This selection 
allows you to save the information in the RE- 
CEIVE BUFFER to disk. When you make this 
selection the program prompts you for a file- 
name, asks if you're sure, then saves the 
information. 

PRINT RECEIVE BUFFER - This selection 
prints the RECEIVE BUFFER out the serial port 
of the COCO. I haven't tried this function and 
have no idea what baud rate the serial port 
may be operating at. J assume it is standard 
Radio Shack (600 baud). 

SHOW RECEIVE BUFFER - This one displays 
the entire buffer on the screen. This allows 
you to go back over received text in case you 
forgot a name, callsign or whatever. 

RECEIVE/TRANSMIT - Pressing ENTER on this 
selection allows you to receive and transmit 
RTTY signals via the cassette port. There is a 
split screen with the bottom two lines being 
for transmit (you can type while receiving) 
and the 13 lines above for receive. The top 
line is where the tuning indicator is located. 
The indicator looks like this: 



When a RTTY signal is received a cursor will 
bounce back and forth between the words MARK 
and SPACE (The receiver must be in lower side- 
band or have a BFO for this to work). 

LOAD TRANSMIT BUFFER - This one allows 
you to load a pre-written piece of text into a 
buffer. At the appropriate time it can be 
transmitted using the RIGHT ARROW key. 

CLEAR ALL BUFFERS - Just like it says, 
clear all (receive ahd transmit) buffers. 



Confined On 
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BAUD RATE: 45WPM: 60 - Pressing the ENTER 
key on this selection allows you to pick the 
desired baud rate. The software always starts 
at 60 baud (45 WPM), but other selections 
include 67 baud (50 WPM), 75 baud (57 WPM) and 
100 baud (74 WPM). 



Now most of your RTTY signals will be 
operating at 60 baud, at least in the ham 
bands. The news services use RTTY to send news 
and weather information from around the world 
and they frequently use the higher baud rates. 
There are publications available that list all 
known RTTY frequencies and what can be 
expected there. Once the program is running 
you'll need to get that old Cassette cable you 
thought you wouldn't need anymore. Plug it 
into the cassette Port on the rear of the 
computer. Connect the Black plug to the 
receive audio coming from your radio. Turn on 
the radio and tune in a RTTY signal. Remember, 
your radio must be capable of receiving lower 
sideband or have a BFO (Beat Frequency 
Oscillator) to receive RTTY signals. 

To transmit RTTY connect the larger (Srey 
plug to the microphone input of the trans- 
mitter (you must be a licensed Amateur Radio 
Operator ) . Tbe smaller Grey plug is used to 
key the transmitter. Be careful here, Jf 
you're using an older rig you might want to 
rig some type of relay between the smaller 
grey connector and the radio. Some of the 
older transmitters had a fairly high DC 
potential on the keying line, 

A good starting place is 
Meter Ham Band. Look around 
Mhz. The ARRL (Amateur Radio 

also has regularly scheduled transmissions. 
I've included a table showing the times and 
frequencies for their RTTY bulletins. 

Last, but not least, where can you get 
these programs? Well, there are at least 
three ways: 



in the Twenty 
14.080 to 14.1 
Relay League) 



1 - Type in the programs from 
listings included here. 

2 - Subscribe to the CoCo Clipboard disk 
service . 

3 - Download the programs from 
Compuserve. They're in the HAMNET Forum in 
Library 0. 

Until next time! 73's 

KE4PC 
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de Mike Dooley 



ARRL W1AW Schedule 



UTC 
EDT 
CDT 
MDT 
PDT 



Daily: 0100, 0400, 

Daily: 6 PM, 9 PM, 

Daily: 5 PM, 8 PM , 

Daily: 4 PM, 7 PM, 

Daily: 3 PM, 6 PM, 



2200; 
12 PM 



MTWThF: 
MTWThF : 
1 PM; MTWThF: 
0 PM; MTWThF: 
9 PM; MTWThF: 



1500 
11 AM 
10 AM 
9 AM 
8 AM 



5 REM THIS PROGRAM IS PUBLIC DOM 

AIN, BY N6LQV 

10 CLEAR 200,&H4000:C=3 

20 D= ( PEEK ( &HC000 ) =68 ) : REM TAPE: 

D=0, DISK: D=-1 
30 IF D THEN LOADM " RTTY " ELSE CL 
OA0M"RTTY " 



40 DEFUSR0=&HEOO:DEFUSR1=&HE03 

50 DEFUSR2-&HE06:DEFUSR3 = 8,HE09 

60 DEFUSR4 = &HE0C:DEFUSR5 = 8.HE0F 

100 A=USR0(0) :R=0:T=0 

110 CLS:AUDI0 0N:M0T0R OFF 

120 PRINT"**** RTTY TERMINAL PRO 

GRAM ****" 

130 PRINT" 

BYTES" 
140 PRINT " 

";R 

150 PRINT" 
160 PRINT" 
170 PRINT" 
180 PRINT" 

";T 

190 PRINT" 
200 PRINT" 



SAVE RECEIVE BUFFER 

PRJNT 
SHOW 

RECEIVE/TRANSMIT" 
LOAD TRANSMIT BUFFER 



CLEAR ALL BUFFERS" 
BAUD RATE: " ; 
210 ON B+1 GOTO 220,230,240,250 
220 PRINT"45 WPM: 60":GOTO 260 
230 PRINT"50 WPM: 67":GOTO 260 
240 PRINT"57 WPM: 75":GOTO 260 
250 PRINT"74 WPM: 1 00 " : GOTO 260 
260 PRINT 

270 PRINT " DURING RECEI VE/TRANSMI 
T : " 

280 PRINT" BREAK: RETURN TO THIS 
MENU " 

290 PRINT" CLEAR: TOGGLE RECEIVE 
/TRANSMIT" 

300 PRINT" RIGHT ARROW: TRANSMIT 
BUFFER" ; 

310 A=C*32:PRINT@A+32, " ";:PRIN 
TQA + 64, "->" ; :PRINT<8A+96, " "; 




* * i) i stuibutorship** 
oqfeee/ related 

It* R.O DUCTS 



If you are ready to own your own 
business and are tired of weeding 
through the clutter, give us a call. 
Uncle Charlies offer products that 
people want at prices that are far below 
traditional establishments. Our lines of 
coffees, teas, breakfast drinks and meal 
replacement products sell because they 
are of superior quality and yet sell at 
prices far below the national brands. We 
are looking for key distributors 
throughout the coutnry to begin 
operations i mined iately . We offer 

complete company training and support. 
You will require approximatley 20K in 
capital to begin. If you qualify, phone: 



The Zebracki Group 
(716) 366-4248 / 4359 



Tyranny of Compatibility 



Rush Caley 



It was a phone conversation that finally 
pushed me over the brink of my long standing 
position of disinterest toward discussions in- 
volving hardware comparisons. I had been 
speaking with another long time CoCo en- 
thusiast, about various topics. He spent a 
great deal of time telling me of the 
limitations of the CoCo and praising the power 
and wonder of his sleek new PC and a new 
relational database program. He had outgrown 
his CoCo - no way could it compete. The bal- 
ance of the his eonversat ion revolved around 
the i ropor tance of "compatibility" i n today's 
business world. When I hung up the phone, I 
was frustrated and even a bit angry. I still 
feel that way; so naturally I wbs pleased when 
CoCo Clipboard provided the opportunity to 
vent some steam. 

But this will not be a typical 
"1- love-my-CoCo" type of article. I will not 
go on and on about how the CoCo serves my 
needs and its ease of use or less expensive 
software. Face it, in many cases, we don't 
even have the pricing "leg" to stand on any 
more. 1 will not be discussing Intel and 
Motorola microchip architecture; nor will I go 
over the tired old comparisons between IBM and 
CoCo, or MR-DOS versus Ofi-9. These have been 
summarized many times by technicians much more 
knowledgeable than I. 

What this is about is the subject known 
to all of us an "TDM Compatibility." I cannot 
count, the number of times that I have heard 
prospective computer purchasers admit that 
they do not know exactly what they want- or 
even need. Hut one thing about which they are 
positive, is that it must be IBM compatible. 
In many cases, they may not even know what the 
term means! Well, as you know, all this 
amounts to is that the machine roust operate 
under MS-DOS and run all of the popular pieces 
of DOS software that have become standards in 
the business community. But this is not a 
problem! The fact that this DOS and these pro- 
grams are so popular does not bother me at 
all. Competition in the marketplace is what 
makes America tick. 

What does irk me is the implication that 
T cannot enjoy any real measure of success if 
I do not utilise the "standard". Now I am not 
talking about the "you can't get the girl if 

you don't drive a " type of advertising 

gimmick. There is much more than a Cadillac/ 
-Chevy type of snobbery lurking here. If that 
were the case, anyone with any sense of 



individuality would ignore it. 1 could. You 
could. Do we all use Dial soap? No. Do we all 
drink Coca-Cola? No. And so on. 

But there is an ideological tyranny being 
set up here - skulking in the background and 
forming a perimeter around our freedom of 
choice! The technique is called BANDWAGON, And 
it is a particularly insidious form of prop- 
aganda. When properly used, it can even be 
unknowingly self-inflicted. ("Well, I'm not 
sure, Mr. Salesperson, but it has to be IBM 
compatible.") But I must repeat- I am NOT 
against the IBM PC or the company itself. What 
I AM against is this slavery to the concept of 
compatibility- of ANY kind! First it is "nice" 
to be compatible; then it becomes "fash- 
ionable"; next we "ought" to be compatible; 
and finally, we "must" be compatible, 

tet me just throw out some realities. I 
don't care how many businesses out there use 
computers. For every one that does, there are 
at least twenty that do not. Of the ones that 
do, many do it badly or inefficiently. We have 
come a way in the last five years or so; but 
we're not where some might think. Computers 
are not every day toaster-like appliances in 
the office or in the home. There is a long way 
to go. The market has only been scratched on 
the surface in terms of numbers; and barely 
even that when it comes to the relation be- 
tween capability and actual use. The "paper- 
less" society is a forever away, and maybe 
even then, still someone's pipedream. This is 
the encouraging news! There's still time to 
avoid mass conformity! 

I have used electronic mai l, since J 983 
and never felt the need to be compatible. 1 
ran a large Parish and School for 3 years on a 
CoCo and three programs. Not once did I need 
to be compatible. I have written every piece 
of personal correspondence and magazine 
article since 1981 on a CoCo ...sans com- 
patibility. I keep all my business and 
personal records on my CoCo. Never once has 
anyone ever convinced me I need to be com- 
patible. I don't care what computer you use or 
like. If your TI still works, fine. If your 
Sinclair continues to hum, all the better. If 
your Epson QX 10 and Valdocs interface suits 
you, perfect! Even if your dream is a spanking 
new IBM/ OS-2/ 386 monster, I have no quarrel. 

It is simple. When the push for com- 
patibility reaches the fever pitch it has 
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today, then it is ; no longer compatibility, it 
is CONFORMITY. Let's take a look at it from 
the eyes of my electronic thessaurus. I 
punched in the letters C-0-N-F-O-R-M . Fol- 
lowing are the synonyms regurgitated at the 
touch of a button: 

REGULATE, SUBMIT , COMPLY, OBEY, FOLLOW, 
STANDARDIZE, MIND. SHAPE, FIT IN, COALESCE . 

Face it! even a dumb machine knows all the 
negative connotations of the "C-Word" . How 
much more aware should we be? We, who not only 
know the mere "book meanings", but also the 
living realities in the past and present that 
we can attach to words such as those? 

If you are still reading this and have 
not written me off as another paranoid- 
schizo-survivalist from the northwest, r end 
my tirade on this note. In the 40" s and 50' s 
people feared computers and the spectre of 
Orwell's 1984. The reason that picture hnn 
been held at bay is due to the invention and 
proliferation of the PERSONAL COMPUTER! There 
are many countries less fortunate than ours 
where personal computers are less prevalent 
than guns, and both are illegal possessions. 
My hope is that no matter what computer we 
choose to purchase in our free, competitive 
market, that we all maintain the desire, and 
the right to keep personal computers exactly 
that: personal! The CoCo is one of the most 
personal of all computers while still very 
powerful. C'mon forget the "C-word" and have 
some fun! 



NEW ** NEW ** NEW ** NEW ** NEW ** NEW 
B asic09 Subroutine Pac kage 

A must package for anyone writing programs in 
Basic09. This collection includes routines to 
convert strings between upper and lower case, 
nifty routines to display menus and disk 
directories (CoCo3 only), midstring" replace, 
SOUND rountines. Extended Color Basic DRAW 
emulator, LINEINPUT with visual editing, file 
handlers for file size, modification dates, 
setting file size, etc. PLUS much more! 24 
routines in all, ail written in super-fast 
machine language. Complete documentation makes 
it easy to interface to your programs. 

0S9 Level 1/2 $24.95 

Ul tra Label Make r 0 9 

The original Ultra Label Maker received rave 
reviews! Now it's available for 0S-9 users. This 
Cadillac of label making utilities will turn 
your printer into a label factory. Labels are 
created on the terminal screen with complete 
previewing — you'll see how the label will look 
before you print a single one, even underlining 
and italics are shown on screen. Formatiing is a 
snap with auto-centering, justification, etc. 
Automatic numbering option. You've got to see 
this to believe it. 



512K 0S9 Level 2 $19.95 
$14.1 



RS-Dos 32K 
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Sorry, no credit cards — enclose check or money 
order plus $2.00 shipping and handling. Complete 
catalog available — send $1.00. 

Bob van der Poel Software 
17435-57 Avenue 
Edmonton, Alberta 
Canada T6M 1E1 



Continued From 5 

350 FOR 1=0 TO 30:NEXT 
360 A$= INKEY$ 

370 IF C>0 AND (PEEK(341) AND 8) 

=0 THEN C=C~1:G0T0 310 

380 IF C<6 AND ( PEEK ( 342 ) AND 8) 

=0 THEN C=C+1:GOTO 310 

390 IF A$OCHR$(13) THEN 360 

400 ON C+1 GOTO 800,500,550,600, 

700, 100,950 * 

500 IF (PEEKUHFF22 )AND1 ) THEN 1 
10 

510 A=USR5(-2):PRINT M ":GOTO 1 
10 

550 CLS:A=USR5(0) 

560 IF INKEY$= THEN 560 ELSE 1 
10 

600 CLS : PRINT"RTTY RECEIVE M 
ARK-- > <- -SPACE " :R=USR1 (B) : GOTO 1 
10 

700 S$="LOAD FILE":GOSUB 900 
710 IF A$="" AND D THEN 110 
720 CLS : PRINTQ2 29 , " LOADING "';A$ 
730 IF D THEN F=1 ELSE F=-1 
740 OPEN " 1 " , F , A$ : A=USR2 ( 0 ) 
750 IF EOF(F) THEN 790 
760 LINEINPUT #F,A$ 
770 A$=A$+CHR$( 1 3) :A=USR3(A$ ) 
780 IF A THEN 750 

790 CLOSE F:T=USR4(0) :R=0:GOTO 1 
10 

800 IF R=0 THEN 1 10 

810 S$="SAVE FILE":GOSUB 900:IF 

A$="" THEN 110 

830 CLS:PRINT@229, "SAVING " ; A$ 
840 IF D THEN F=1 ELSE F=-1:G0T0 
870 

850 PRINTQ293 , "ARE YOU SURE (Y/N 

) " ; : INPUT S$ 

860 IF S$<>"Y" THEN 110 

870 PRINT®293, " " : OPEN "O" , F , A$ 

880 A=USR5(F) : CLOSE F : GOTO 110 

900 CLS:PRINTS$:PRINT 

910 LINEINPUT" FILENAME?" ;A$ 

920 RETURN 

950 B=B+1:IF B>3 THEN B=0 
960 PRINTQ269 , " " ; : GOTO 210 
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Hard Disk Mania Sweeps 
America! 

Experts Blame "Incredibly Sane" Low- 
Cost, High-performance Interface 

This year, 1988, may go down in CoCo history as "The Year of 
the Hard Disk". The Burke & Burke CoCo XT hard disk interface 
has made high-performance hard disk systems a reality for 
hundreds of satisfied Color Computer users! 

Megabytes, not Megabucks. 

The CoCo XT hard disk interface from Burke &V Burke lets 
you connect up to 2 low cost, PC compatible 5-1 20 Megabyte 
capacity hard drives to your CoCo. You buy tho drive, Western 
Digital WD1002 WX1 or WD1002-27X (RLL) controller, and a 
case from the PC dealer of your choice. Just plug them into the 
CoCo XT, plug the CoCo XT into your Mulli PAK, and you have a 
20 Meg OS9 hard disk system for under $4501 

Great for multiuser systems I The CoCo XT interface uses 
advanced "NO HALT" hard disk controllers, which do not halt 
your CoCo and do not disable or use interrupts during hard disk 
access. You gel full type-ahead, and the system clock does not 
lose time during hard disk access. Fully compatible with most 
RS 232 expansion ports! 

CoCo XT (with anodized housing, 60 page user manual, hard 
disk back-up utility and new, Version 2.3 drivers for use with OS9 
& HYPER-I/O) - $69.95. Or choose the CoCo XT-RTC 
(includes real-time clock/calendar with battery backup) - $99.95 

XT-ROM: THE PROFESSIONAL TOUCH Automatically 
boots and reboots OS9 from hard disk. A great convenience; an 
excellent choice for BBS, home control, and imbedded OS9 
applications- Installs in your hard disk controller's BIOS ROM 
socket $19.95. 



Now: Hard Disk for BASIC 

"Dynamic Disk Interface" runs hard 
drives, big floppies, and morel 

You or someone that you know may have the 35 Track Blues. 
It strikes hundreds of CoCo users every year. One day you 
wake up, and say to yourself. "These 35 track floppy disks are 
just too small." 

There's only one cure. More storage. Get it. With HYPER-I/O, 
from Burke & Burke. 



HYPERformance 

HYPER I/O modifies the RS DOS Disk BASIC in your CoCo 1. 

2, or 3 to provide a "Dynamic Disk Interface". Use your existing 
BASIC and RS DOS software with hard disk interfaces (CoCo 
XT, DISTO.others), RAM Disks, and any mix of floppy drives 
from 160Kto 720K each. 

If you use a hard disk, HYPER I/O divides it into a number of 
BASIC directories. Each directory can be as smalt as 80K or as 
large as 3 Megabytes. You can mix directories of various sizes, 
add new directories, or delete directories at will. HYPER I/O 
and OS9 can share one or more hard disks; you can even add 
one or the other at any time without reformatting! 

BASIC for the '90's 

Fully RESET protected, user configurable, expandable, OS9 
compatible, EPROM able HYPER I/O may soon be THE 
RS DOS system of choice for the CoCo 1 , CoCo 2, and CoCo 

3. HYPER-I/O Version 2.5 now available for only $29.95. 

HYPER-IM (RAM Disk and Print Spooler option for CoCo 3 
HYPER-I/O) -$19.95 



Real BASIC for OS9! 




OS-9 LEVEL TWO VR. 01 0O.01 
COPYRIGHT 1M< BY 
Ml CROW ARC SYSTEM* CORP. 
LICENSED TO TAH0Y CORP. 
ALL BOUTS RESERVED 



rsb copn tsaa burke t burke 

DISK EXTENDED COLOR BASIC 11 
copr. iaaj, io»6 BY tanoy 
UNDER LICENSE FROM MICROSOFT 
AND UICROWARE SYSTEMS CORP. 

OK 

LOAD -DEMO- 

OK 

I 1ST 

10 PMOD6 4:SCRFEN I.I 

20 X=RHO(2M)-l:Y=KND(1»21-1 

30 XS = RNO(256-K)-1:YS = nND(m-Y)-1 

40 IIHE tX.Y).(X,»S.Y.YS).PSET,F>F 



Welcome to 



R. S. B 



S.. n.S.S. and other Burke * 
Burke products «t th* Princeton 
Ralnbowf*»t. Don't ml** our Herd 
01 ak Seminar) 



There Is nothing wrong with your Color Computer, Do not attempt to adjust It. Tho BASIC you know end love Is now 
running under Level 2 OS9 windows. You are in command. 

Burke & Burke is proud to present another OS9 programming language: Disk Extended Color BASIC. 

You've probably heard of this language. It's the one your Color Computer was born with. We're talking PMODE, DIR, COLOR, 
RENUM, PLAY and other familiar words. Under Level 2 OS9. In as many windows as your memory lets you create. 

Our R S B. software creates an OS9 compatible version of Disk Extended Color BASIC by reading your CoCo's ROM chips. We add 
now software for OS9 style graphics, sound, printer, and disk I/O. Of course, you can't use R.S.B. to run machine language programs, 
and some BASIC commands work slightly differently under R.S.B. Although R.S.B. loads and saves files using OS9's file format, 
we've also included utilities to transfer BASIC programs and data files between OS9 and BASIC disks. 

Did you know that Level 2 OS9 always runs at double-speed? This makes R.S.B. very fast. You must have a CoCo 3 with at least 
1 28K RAM, and a floppy controller with Disk Extended Color BASIC 1 .0, 1 . t , 2.0, or 2. 1 ROM, or CoCo 3 CDOS ROM, to use R.S.B. 



Wild & MV Version 2.1 Use "Nvildcards" 
with most OS9 commands, or rearrange your 
directory tree. Features recursive directory 
searches. A hard disk must! $19.95 



Check out these OS9 Utilities 

Tools to tef you spend has time fighting OSS, 
and mora time using H. 



EZGen Version 1.04 Powerful OS9 
bootfile editor. Change module names, add 
or delete modules, patch bytes, or rearrange 
modules. Works on other (ties, too. $19.95 



P.O. Box 1283 Patai»n«, IL 60078 1283 (312) 307-2808 



Illinois Residents please add 7% sales tax coo-» add 

$2 20. Shipping (withm th* USA) $2 00 p«r CoCo XT; $1 .50 p*r dtk or 
ROM. Pitas* allow 2 weeks for delivery (overnight delivery alto 
avertable for in stock items) Telephone orderi accepted 
(312) 407 2B08. 



Deluxe PowerGraph Pt. II 



Randy Krippner 



In this issue we conclude Deluxe Power 
Graph. It's been a lot of fun working on this 
program, and I'd like to thank everyone who 
helped with the development of the program, 
especially Boh van der Poel, His suggestions 
early in the development of DPG made it a much 
more interesting program. 

If you find the prospect of typing the 
entire listing intimidating, you can get a 
copy of DPG on disk for $9.95 from CCHOisk 
Service. Just write to them and order the Clip 
Disk for July/August. Please don't write to 
me requesting disk copies of the program. I'm 
sorry, but r just don't have the time or the 
resources . 

Several people have asked about enhancing 
DPG. I have several enhancements in mind for 
the program. One enhancement, an "Undo" func- 
tion, has already been developed. (People who 
get the ClipDisk will obtain the latest ver- 
sion of the program, including the Undo 
function. This enhancement was added too late 
to be able to get it in the magazine, but we 
were able to get it on the ClipDisk version.) 

Adding other features to DPG is not easy. 
The program is just about "maxed out" as far 
as memory is concerned. The maximum size DPG 
can have is about 24K, and it is pretty close 
to that already. 

Why, I hear someone asking, can the 
program only be 24K long when Baaic09 gives us 
about 40K + to play with? You have to remember 
that part of that free memory is taken up by 
the GFX2 , Inkey and Syscall modules. The rest 
of that free memory is eaten up by the 
graphics buffers used to save/load pictures 
and by the cut and paste buffer. But there 
are a few little tricks that can be used to 
get around this difficulty. 

If you want to tinker with the program on 
your own, here's a little hint for you... 
Although DPG is maxed out, there is nothing to 
prevent you from setting up a utility program 
in another window. Remember, the Coco 3 is a 
mul ti -processing , mutli user computer under 
OS9 L2 . We could have another program chock 
full of DPG utilities running in another win- 
dow, and switch back and forth just by 
pressing the CLEAR key to switch windows. 

What makes this possible is not just the 
fact that OS9 L2 is a multi-processing op- 
erating system, but also that OS9 L2 graphics 
buffers are system wide. This means that, for 
example , once you "cut" a portion of a pic- 
ture and place it in the cut/paste buffer with 
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DPG, that graphics buffer can be accessed by a 
different program running in a different 
window. So after doing a "cut", we could flip 
to a new window that is running a utility pro- 
gram, somehow modify the contents of the 
buffer with the utility, flip back to DPG and 
then paste the modified buffer back into our 
picture . 

Bugs: Well, not exactly a bug. Let's call 
it a quirk. You can't PACK DPG. Well, you can, 
but it won't work right. Everything will work 
until you try to save or load a picture. It 
will go through the motions, but in actual 
fact nothing will be saved to disk. 

So don't try to PACK the program. You'll 
have to execute it from within Basic09. If 
someone comes up with a quick fix for this, 
I'll pass it along. 

The Unicorn: I've been mentioning the 
Unicorn BBS in the past. Due to circumstances 
beyond our control, the Unicorn is currentlj 
down. By the time you read this, it should be 
back on-line, but operating at a different 
phone number. As soon as I know what the riev 
number is, I'll mention it in a future column. 

Next time we'll take a look at Multi-Vue, 
It's an interesting piece of software, but 
Tandy and Microware failed to provide a way U 
make new Multi-Vue icons. So next time we'li 
present a Basic09 program that not onlj 
permits the creation of new icons, but whicl 
will also automatically generate AIFs (ap- 
plication information files). 

As always, if you have any questions oi 
comments, please write to met at: Rand; 
Krippner, 1014 W. Hwy. 114, hot 39, Hilbert' 
WI 54129. 

J********************************************* 

* e — 3 — i 

* 

£ SAVE 15X FROM LIST PRICE 

X Just in time for holiday giving it's 

J 6-2-1! "6-2-1" is our new program to save 

* your money! 6 back issues of Clipboard, a 
{ 2 year subscription to Clipboard and 1 
t year of ClipDisk. Normally $97. 95 now you 
J can save 15% only $83.25! Just write in 
{ "6-2-1" on the order form on page 18. 

t MC-V isa-Discover accepted. 
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PRESENTS 



ClipDisk 



FULL YEAR (6 issues) Only $49.95 ! 



Now all the LUSIC, C, HAS 1 CO 9 , Assembly i,am,MJa^'o and OS9 
programs you see in CoCo C.1 i pboaid Mfiga7,itH» are available on 
disk. With ClipDisk you ' 1 I save time an be more productive 
computing with jour Color Computer. 

A subscription to ClipDisk is $49.9fi for li issues. Single 
issues are available as well for- .just $9. 9b. Of course in 
order to get. the full benefit ol CJiplnsk you'll need the 
corresponding issue of Co Co Clipboard. ClipDisk is not a stand 
alone item, but rather a real help in enjoying Clipboard 
Magazine and your CoCo. 



So ij'.m ' t dt-l/ty, got your .•ntltsar t fit. i on in It/day! 
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I've enclosed (check one) ( ) J. year of ClipDisk $49.95 

( ) single copy 9.95 

Specify month desired 



Canadian customers can also obtain ClipDisk for $49 95 
when paid in U.S. Funds. »«.*.. *♦ 



*©3 . S3 
SAVE 15* PROM tIST PRICE 



City: 

Stntr? / I'rov: 

Zip / I'oBLnl Oorlc 



i 

{ Just In time for holiday giving It's 

J 6-2-1! "6-2-1" Is our new program to save 

{ your money! 6 back Issuas of Clipboard, a 

J 2 year subscription to Clipboard and I 

! year of ClipDisk. Normally $97.95 now you 

{ can save 15* only »83.25! Just write In 

X 6-2-1 on the order form on page Id. 



<rii<ir*e my ptirnl.nnc to my (<:lr»:li!) VISA / Kt»iit.pr<;, 

dnrd I 
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"H / Dlnoover Cmi). 



Cs»r<yterS?l.vJce» 

HOT CnCo CI I photf riJ HnfinrA 



„,., r.riiclrt ennttr-ny of Qn Unt 



CoCo 

Clipboard Magazine 3742 U.S. 20 Box 3, rredonia. N. Y. 11063 
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Yon can use UltiMax a s 

joystick interface <-> c 
used with a popular M.- 
[•rogr.im. Thr= otlirr fn; 
is the option to hnvn ,- 
stick a r p a s ci y u 1 1 can f 
with your draw i ik].t ! 

The DltiH.ix inter faco is only S^'K 1 >''> 

Or tcadp in you! ori'jina] HiKps int^r 
faco ( sent pop t a go propiirl ) and -jst 
$M.9f> 



UltiMax for onl- 



Wi th nnCPl.AY an 
Tiles (Included 
r, HIT sound qua 

download ottier MAC sound files 
information service or MAC bull 
to hear oven more. Pound fileu 
seconds ot up to 1/2 minute. MAC sound files 
included on the seconds diskette contain excerpts 
3 Stooges to the Hoad Runmier and morel I 



MACPI.AY is orrly $ 19.95 



CoCo 3 you can pi ay MAC sound 
the second diskette) with pur. p 
that the CoCo can produce! Or 
from a computer 
tin board systems 
a 1 1 last for a feu 



f r or 



PA res jde tits 
add 6% sales 
tax 



Send to: 
CocoTech 
205 Cathy Ann Drive 
Reading, PA 19606 
(215J-779-7768 



Shipping and handling: 
USA and Canada add $2.50 
Other countries add $5.00 

** We now handle 



Please allow 
1 to 3 weeks 
for delivery 

Sorry no 
credit cards 
XETI 
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CoCo 

Clipboard Magazine 



IS THIS YOU 
ON DEC. 24 TH? 




THIS YEAR 
WHY NOT AVOID THE RUSH? 

THIS YEAR GIVE THEM A GIFT 
THEY CAN REAELY USE 

A GIFT SUBSCRIPTION 
TO CLIPBOARD AND CLIPDISK 



When we receive your gift subscription this is what we'll do. A letter will 
be sen! to your friend announcing your gift subscription. We will also tell 
them all about Clipboard and ClipDisk as well as when they can expect their 
first issue to arrive. 



Subacribj nR 
lleiinwitirt 

Gift Subscription 



ity: 
: " t <- / I'rov : 
'if / ronlfil Cod< 



Gift Subscription 



ft 



/ I'rov: 

Hy check or money order in encjoned 



1 unr of Rllphonrrl * i 5 . 00 US Fund 9 
S K»r, „r CMIpbonrd $28.00 US Fundi. 
> ,*.r Cornelian $1B 0 „ us Funda 

1 ynnr Ov, rm ,» $27.1)0 (IS Funds 

SlMftln Inn.io c:ll,.nlnk $9.95 tlfi Fun-in 
PrnclfT Hoi, Mi 

1 l^.r or CJIpDtnk $19.06 IIS FunHn 
flnrli r^ur.*, J |.„ rl , B $20.00 US Fnn.ln 

"6-7-1" 6 back Issues of Clipboard, a 

2 year subset (prion to Clipboard and 1 
ynor ol" ClipDisk. 

Normally $97.95 now only $83.25! 



Tot.nt 

l ' 1 "" nn clmiK« »y piirchnni; to my (circle) VlfJA / Hnn ten Card / ninco 
fir.l I 
Exp. Dot r 
Sl«nnl.„ rl . 

FJfASS.flpjl! ,11? nh»r* n -■„,,! 



*n — ^r^- srSc r <e?9 ' Vour c '" ,r ' fo ca ^ ""I show on-line 

Clipboard Magazine 3742 U.S. 20 Box 3, Fredonia, n. Y. 
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T&D Subscription 
Software, 

an advertiser 
in this magazine, 

wants to introduce you 
to their variety of 

inexpensive software 
by giving you a: 

FREE Disk or Tape 

Filled with 10 programs 

1 coupon per household 

Circle one: TAPE DISK 
Mail this coupon to: 

T&D Free Offer 

P.O. Box 1256 
Holland, Ml 49423 



ARK ROYAL GAMES 

P.O. Box 14806 mr ARK 

Jacksonville, FL 32238 L|ROYAL| 

(904) 786-8603 Kl GAMES j 

10£ Off uny Ark Roynl product 
in their ed with this coupon from 
Clipboard ! 





STOCK MARKET PORTFOLIO 
FOR THE COLOR COMPUTER 



Savm 107. on Stock 
Market Porfolio wit/> 
this Clipboard Coupon 



Taparis Enterprises 
700 York Si. 

Williamsburg, VA 23585 



idiUMiMfcriiiiiliMM 



Me can now offer COLORS for many nylon cartridge 
ribbons. Our RAINBOH-PAK contaip 6 different 
colored ribbons. Write for prices. Specify your 
printer's name i model. 



Harty's Rubber Stamp Shop 
47 South Second St. 
SAINT CLAIR, PA 17970 
(717) 428-1052 
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3 u, t. o) a 



S«v« 10X on C.S.6. 
— with thi» coupon — ^ i 
Clearbrpok Software. Group 



Information 

Management 

System 



, (Wtiid, lnd.it, Lid r.l. 

. l««t, BCOflnlins po>"l 
|M<l<»'li|.i>ofl melons 



CSOIMSIoiC<.C<i2/3 0S9ltf2|«ln fl r) |I69» 

CSG IMS loi OS* U or 68000<trujW uur) MWCO 

CSQ IMS d*mo ~IU> mul 130 00 

OTHER CSQ rnOOUCTS: 

EIWA Syffi>»"' Um-mod. 0>t>u 8 g»i lot OS» US 00 

SERINA S^Um-modl CuboOB"''" OSSt...»l2 «I3»00 

MSF MiOOS Flk M«/i«g»f h* CoC« JJCJS9 U *« 00 

MSFwIttl SDISK3 W5 00 

Shipping - N. Amiilc*: U. C*.tt.«»: 110 



Cle»rbrook SohwBre Gro.ip, Inc. 



FREE 
POT Cir- COFFEE! 

Uriels? Charlie's mountain 
grown coffee is of the 
h i ghest qual i ty and 

lower in price than 

store bought coffee. 
Unly 3 1/4 cents per cup 
for regular and 4 1/2 
cents for decaf! 
GIVE US A TRY... FREE PUT 
OF COFFEE ON US. JUST 
FILL OUT COUPON «nd a p n d 
to The Zebracki Group, 
332 Central Avenue, 

Dunkirk, N.Y. 1404B. 

YES' SEND HE A POT OF UNCLE CHAfiUE'S COFFEE 
FREE ... 1 LL BE IliE JUD6E! 



tlamc? 

Aildr cT><i 

City State. 

Zip Phone 
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<« GIMMESOFT >» 

QJIjttf certificate eutiUeti 

tu - /o y z uft 

Il)dr next iimtljaae. 

3Non hauufctalile anh not ualih tuitl) any 
ntffer aale pricea ur ccrtifitttteja. 

(3ljiH offer expires: s^t i, nt? 
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va^a'a'a'a ' a 1 ' v a ''A',' 
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2 0* O J?' F ! 

TELEWRITER-1 28 

Send this coupon with $65.96 for a disk 
copy of the fastest, smoothest, easiest 
to use word processor available for the 
Coco III. Telewriter-128 - A precision 
writing tool available from: 

Cognitec 

704 Nob Ave. 

Del Mar, CA 92014 

(offer expires Oct 31, 1988) 




Master Basic09 



Bill Brady 



>mehow a few things failed to appear in 
J»e printed copy of the column last issue. I 
lo not know how this came to be, but I will 
•epeat all of the missing parts here, and, 
lopefully, make the salient points clear. 

Now what was that main point? Ah yes, 
tYSCALL, the why and when. 

I tried to show you how error handling is 
Ireatly simplified by the use of syscall. I 
.{■ve examples of creating a file, the first 
•eing the 'vanilla' Basic09 way, the other 
wed syscall. Lets try again to get this ex- 
»ple in a form that you can see. We are 
nriting a program that uses a subroutine at 
000 as the 'catch all" error handler. At some 
•oint within the program, we are going to 
rreate a new file. If that file already 
jxists, we will create a new file, using the 
lame name, but append a ".1". 

Here is method "A": 



* location 1000 is our generic 

* error handler 

1 ON ERROR GOTO 1000 
J ******************** 

* Here starts our subroutine 

* first we set up a new 

* error routine at Joe 50 

* this is so we KNOW that 

* we got there from here 

* and not someplace else 

I 

|0 ON ERROR GOTO 50 

|* now we attempt to create 
[* our file 

tRBATE #path, "filename": WRITE 

J* OK we got past the CREATE 
f * now we have to skip the 
I* local error handler, and 
)* restore the generic error 
I* routine at 1000 

?K ERROR GOTO 1000 
POTO 60 

C* here is the local error handler 
I* where we look to see if the fill 
I* already exists., error 218 



(* note that we could get here for 
(* any of several reasons, so the 
(* routine will enter the generic 
(* handler if it gets anything other 
<* than 218 

50 en=ERR 

IF en=218 THEN 

f ilename=f ilename+" .1" 

ELSE 

GOTO 1002 

ENDIF 
GOTO 40 

60 (* continue with program 

1000 en=ERR 
1002 IF en=. . . 



Here is method "B" (using syscall) 

40 s . a=2\s . b=7\s. x=addr( filename ) 
RUN syscall ( $83, s) 
IF s.b=218 THEN 

f ilename=f ilename+" .1" 

GOTO 40 

ELSE 

en=s . b 
GOTO 1002 

ENDIF 

($83 is the CREATE system call. Entry: a = 
access mode, b = file 

attributes, x = address of the pathlist. , 
(filename). Exit: 

a = path number, b = error code.) 

A lot less work eh? Well, maybe, because 
you do have to define the "S" variable... we 
did that last time, remember the TYPE State- 
ment? But you only have to set up the syscall 
register pak once in each program/procedure, 
and you can use it over and over. The dif- 
ferences between method A and method B include 
simplicity and speed. You also pick up some 
power . Lets take a look in more detail. 

SIMPLICITY. Note the "IF s.b=218". The CREATE 
system call, like most system calls, returns 
error numbers in the B register. You grab and 
deal with the 'file already exists error' 
right there in the subroutine, no ON ERROR 
GOTO. You know precisely when and why 
error 218 occured. What could be simpler? 
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" LJ±ndow Master" 



A Point & Click klindow System 
for the rest of us fff 

Fully Compatible with ff.S. Dos 
Enhanced Basic, it does not need 
or use OS-9, and you don 5 1 have to 
be a Rocket Scientist or a P.H.D. 



to use Windows, 
Buttons, Icons, 
House Functions 




Uindov Waster 
F inder VI . 0 



Uritten by Bill 
Copyright Cc J 



Vergona 
1388 by Cet — Comp Ltd 



Screen Display Foots 



Window Master supports up to 54 different character sizes on 
the screen with 5 different character styles. You can have Bold, 
Italic, Underlined, Super-Script, Sub-script or Plain character 
styles or any combination of them in any character size. You 
can also change the text color and background at any time to gel 
really colorful displays. 

_ Fully Basic Compa tible 

Window Master is fully compatible with Enhanced Color 
Disk basic with over 50 Commands & functions added to fully 
support the Point & Click Window System. Window Master 
does not take any memory away from Basic, so you still have all 
the Basic Program memory available. 

Hi-Resolution Display s 

Window Master uses the full potential of the Color 
Computer 3 display by using the 225 vertical resolution display 
modes instead of the 192 or 200 resolution modes like most 
other programs. It uses either the 320/16 color mode or the 
640/4 color display to give you the best display resolution 
possible, and can be switched to either mode at any time. 



Pull Down Menus, 
Edit fields or 
in your Programs! 

Window Master Features 

Multiple Windows 

Window Master supports multiple window displays with up to 
a maximum of 31 windows on the screen. Overlapping windows 
arc supported, and any window can be made active or brought to 
the top of the screen. Windows can be picked up and moved 
anywhere on the screen with the mouse. There are 6 different 
Window styles to choose from and the window text, border and 
background color is selectable. 

Pull Down Menus 

Menus are completely programmable with up to 16 menus 
available. They can be added or deleted at any time in a 
program. Menu items can be enabled, disabled, checked or 
cleared easily under program control. Menu selection is 
automatically handled by Window Master & all you have to dc 
is read a function variable to find out which menu was selected. 

Buttons, Icons & Edit Fields 

Each Window can have up to 128 buttons. Icons or Edit fields 
active, if you can fit that many. Buttons, Icons and Edit dele 
selection is handled automatically by Window Master when the 
mouse is clicked on one. All you have to do is read a Dialos 
function to find out which Button, Icon, or Edit field wa: 
selected, its very simple. 



Mouse & K eyboard Functions 

Window Master automatically handles the Mouse pointe; 
movement, display and button clicks. It will tell you the curren 
screen coordinate, the local window coordinate, window numbc 
the mouse is in, the number of times the button was pressed 
which window number it was clicked in and more. Th< 
Keyboard is completely buffered, and supports up to 81 
programmable Function keys that can contain any kind o 
information or command sequences you can imagine. You cai 
load and save function key sets at any time. So. you can havi 
special sets of function keys for different tasks. The "Ctrl" key i 
supported so that you have a full control code keyboan 
available. 



OPTIONS 



I CLEAR SCREEN 
1 BOTS 
■ BOX 

CIRCLE 

LINE 
| QUIT 

I LOAD 



1 6, 1 



1,0,3,2, 



PHIC6 DEMO = 

IONS", "CLEAR SCR 
" , "CIRCLE" , "LIME 
OAD " , "SAVE" 
44 



;a UIMDOU OPEN 
2,2,8, "UINDOU GRAPHICS DEMO" 

id MU=1 : ' MY UINDOU *=1 

50 ON MENU GOSUB 540 

~9 MENU ON 

?8 PROTECT 3 

?B ON DIALOG GOSUB &38 : DIALOG 



UIHBOH GRAPHICS DEHO 

FOREGROUND 
* COLOR ™ 




Window Master fully supports bolh Tex! & Graphics displays 
deven lias a Graphics Pen thai can be used with HEINE, 
' IRCLfi, HSET and more. You can change the Pen width & 
-r:h and turn it on or off with simple commands. We also 
:ird Enhanced Graphics Attributes that allow graphics 
venients to use And, Or, Xor and Copy modes to display 
"irhic information. With the Graphics enhancements added 
■ Window Master, you could write a "COCOMAX" type 
gram in Basic! In fact we provide a small graphics demo 
■-pram written in Basic. 



Event Processing 



Window Master adds a powerful new programming feature to 
? = sic that enables you to do "Real Time" Programming in Basic. 

s called Event Trapping, and it allows a program to detect and 
—spend to certain 'events' as they occur. You can trap Dialog 
ir-ivity, Time passage, Menu Selections, Keyboard activity and 
M-jusc Activity with simple On Gosub statements, and when the 
Reified event occurs, program control is automatically routed 
•- the event handling routine, just like a Basic Gosub. After 
c ::vicitig the event, the sub-routine executes a Return statement 
z-6 the program resumes execution at the statement where the 
r.ent occured. 

Enhanced Editing Features 

Window Master adds an enhanced editor to Basic that allows 
you to see what you edit. It allows you to insert & delete by 
character or word, move left or right a word or character at a 
time, move to begin or end of line, toggle automatic insert 
en/off or just type over to replace characters. The editor can 
also recall the last line entered or edited with a single key stroke. 
You can even change the line number in line to copy it to a new 
'ccation in the program. 



FILES mala 



Window Master pushs the Color Computer 3 far beyond its 
normal capabilities, into the world of a 'User Friendly" 
operating enviornment. We arc already planning several new 
ptograms for use with Window Master. So you don't have to 
worn' about having to write all your own programs. And don't 
fotget that many existing Basic and M.L. programs will run 
under Window Master with little or no changes. The 
Possibilities for Application programs are ' endless: Spread 
Sheets, Word Processing, Communications, Education, Games, 
Graphic Design, Desk Top Publishing and on and on. 

Hardware Requirements 

Window Master requires 512K of memory, at least I Disk 
Drive, a Ili-Pes Joystick Interface and a Mouse or Joystick. 

Technical Assistance _^ 

ir you run into difficulty trying to use some of Window 
Master's features, we will be happy to assist you in any w-ay 
possible. You can write to us at the address below or call us 
between 10am and 2pm Pacific Standard Time for a more timely 
response. Sorry, no collect calls will be accepted. 

Ordering Information 

To order WINDOW MASTER by mail, send check or money 

order for S69.95, plus $3.00 for shipping & handling to the 
address below. To order by VISA, MASTERCARD or COD 
call us at (702)-452-O632 
(Monday thru Saturday, 8am to 5pm PST) 

CER-COMP Ltd. 

5566 Ricochet Avenue 
Las Vegas, Nevada 89110 
(702)-452-0632 
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The Chicago Rainbow Fest opens today, 
and we will be there with Window Master|, 
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Note that you do hot have all of the ON ERROR 
GOTO statements... they take time... each be- 
comes several system call's. 

POWER. Note the *s.b=7'. That's the access 
mode! You can't set that at all from the 
Basic09 CREATE statement. (I forget what the 
CREATE statement defaults to, but I know of no 
way to change it. ) 

I like method B for another reason. It is 
far easier to read the code, you can see what 
is happening.. it is simple. and what some 
folks call 'elegant*. But what may be the most 
important, the use of syscall in this way 
leads to 'bulletproof code... you end up with 
programs that work. 

Back to the Why and When. Here we used 
syscall because we wanted to simplify error 
handling. We used it when we wanted to create 
a file. Now lets look at an example of 
* bulletproof ness' . 

I am working on a program called Wiz Pro. 
Wiz Pro is a multi-part program that uses 
overlays. So what's an overlay? Well, Pro 
ulways leaves a two page chunck. . . 16k, free 
in its process space. As it runs, Pro will 
'overlay' procedures into this space, execute 
then kill them, keeping the 16k space free. 
This way, Pro can be expanded in an unlimited 
way, just so long as each, (basic09), ex- 
pansion fits in 16k. 

These 'overlays' can come into Pros 
process space either from disk, or some other 
t.rea of memory. Naturally, often used pro- 
cedures are best kept in memory, others may be 
kept on disk. In any case, the choice is up to 
the user because Pro executes a 'overlay* 
called WizLoads. WizLoads is nothing more than 
a list of procedures and programs that get 
loaded when Pro does. So, if a user wants so 
and so proc kept in memory, all he has to do 
is put its name in WizLoads. This is what the 
proc looks like: 

PROCEDURE WizLoads 

PA RAM lode(8) :STRING[16] 

FOR 1=1 TO 8 
lode( i) = " " 
NEXT i 

lode( 1 )="WizUtils" 

lode(2)="WizConfig" 

lode(3) = ,, WizClipper ,, 

lode(4)="W P Xmod" 

lode(5)="WizAuto" 

END 

And here is what happens to it: (in Wiz Pro) 

proc="Hizloads" \RUN proc(lode) \ KILL proc 
i = l 

WHILE lode(i)<>"" DO 
SHELL "load "+lode(i) 
i = i + l 
KNDWHILE 

Notice that the files "WizUtils ...Auto" 
end up hanging around in memory beyond this 
point . 



In a particular phase of the development 
of Pro, I wanted to 'clean up' memory when Wiz 
Pro exited. So I used a lines like: 

REPEAT 

SHELL "UNLINK ",lode(i) 
i = l+l 

UNTIL lode(i)="" 

Now, if you had 8 lodes, then the unlink 
command would be called in from ditjk 8 
times... so I made one of the lodes 'unlink'. 
(lode=load.. load is a keyword, you can't use 
it in a program). 

Now came the day I was to send out Alpha 
test copies of Wiz Pro. Although the in- 
structions said "copy all of the Wiz Pro files 
into your command directory", all of the 
testers copied them into a 'seperate' CMDS di- 
rectory, containing... you guessed it... no 
unlink command. So I got phome calls 

How could use of syscall have place some 
armor on this? Well if I had used: 

WHILE lode(i)<>"" DO 
s.a=$22 \s.x=ADDR( lode( i ) ) 
RUN s9scall ( $lD,s) 
i = i+l 
ENDWHJLE 

there would have been no need for the use of 
unlink, no missing unlinks, and no phone 
calls. The program would have been 'bullet 
proof, or at least 'bullet resistant'? 

($1D is the 'unlink a module by name system 
call'. Entry: a = module 

type, ($22 is basic09 subroutine), x = address 

of module name. 

Exit: b = error code.) 

Note that I have not shown these procs 
looking at the ccode register. The carry bit 
is set to one in the ccode register when there 
is an error. You should actually look at this 
bit first, then the b register. 

While reading these syscall examples, a 
question may have arisen in your mind. Suppose 
an error occurs? Like in the WHILE lode(i)<>"" 
DO above... suppose for some reason one of the 
'lodes', (files), isn't there by the time you 
exit? What happens? Do you get vectored off to 
some other 'generic' error handler? The answer 
is no. In this case you just keep on trucking 
until you run out of files to unlink. 
( lode( i ) = "" ) . So, if a file isn't there to get 
unlinked., it don't get unlinked., got it? 

If some other error occurs, well the 
worse that can happen is that something gets 
left behind in memory. 

Now, the next step is to do away with the 
SHELL "load., line in Wiz Pro also! 

So another reason for using syscall is 
when you want to make your Basic09 program 
stand alone... self sufficient. By using sys- 
call you can free your code from things like: 

SHELL "dir" 
SHELL "chd" 



2-1 



SHELL "tmode ..." 

SHELL "link ..." v 

Lets see, if I remember correctly, I pro- 
mised another example of using ayscall to reac 
a file very quickly. Try this: 

DIM BUF (8192): BYTE 

OPEN #path, filename: READ 

10 s.a=path \ s.y=8192 \ s . x=ADDR( BUF) 

RUN syscall($89,s) 

IF s.b=211 THEN 20 

IF s.y<> 8192 THEN 10 

CLOSE #path 

($89 is the READ OS-9 system call. Entry: a = 
path y = # of chars to 

read, x = address of buffer. Exit b=error 
code, y = number of bytes 
read . 

Now you might be getting the idea that ] 
don't like ON ERROR GOTO. I do like it, jus! 
not so much for error trapping. Why don't ] 
like it for error trapping? Well, the mai* 
thing is that when you get to where your OF 
ERROR GOTO goes to, you don't know from wl ire 
you got there! Some Basics have a func. or 
called ERRLN which telle you where the error 
occured. But not basic09. Why? Because Ob 
ERROR GOTO isn't what It seems, and what it If 
makes it really useful in the application oi 
Basic09 to the creation of truly powerful 
programs ! 

ON ERROR GOTO is really a signal in- 
tercept trap! This is why you pretty well must 
have at least one ON ERROR GOTO in every 
program. If you don't, any signal will cause 
an exit. OS-9 signals must be caught, else 
they are fatal, (yes, some are fatal anyway). 

Ever read about OS-9 signals and wished 
you could use them from Basic09? Well, you 
can. In fact, they are easier to use froa 
Basic09 than from C!. Next time I will tell 
you about the 'mouse paws'. 



Join us for our monthly Clipboard 
conference on CompuServe. The 2nd 
Saturday at 9pm Eastern CoCo nota- 
bles and CoCo users meet in an in- 
formal CO in the CoCo Forum on Compu 
Serve. Our September CO will fea- 
ture Chris Burke from Burke & Burke. 
Our October CO will feature Roger 
Krupski from RGB Computer Systems. 
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V NEWTS LETTER 

This is issue 4 of the Clearbrook Software Group Newslet- 



ter. We will put Hie accounting project aside and develope an 
interactive program for creating new data bases. 

It will let us - 

• specify file name and size 

• specify field names, types and sizes 

• specify key names types arid expressions 

• create the data and index files 

Program listing 

MODULE Create 

NOTE Create a new data base 

NOTE a maximum of 40 fields and 5 keys arc allowed 
NOTE maximum field name length is 15 

TEXT fn(30) Or 15 

TEXT It (30) OF 1 

TEXT dt (30) OE 1 

INTEGER fl (30) 

TEXT fm<30) OF 15 

TEXT kn(5> OF IS 

TEXT kt (5) OF 1 

INTEGER kl (5) 

TEXT ke{5) OF 80 

TEXT aS OF BO 

TEXT maskS OF 80 

TEXT £ile_name OF 15 

TEXT ft$ OF 1 

TEXT dt$ OF 1 

INTEGER l,n,i,row,col 

INTEGER name_good, good 

INTEGER fields, keys, records 

namegood^O, good-0, f lelds-0, keys-0, reccrds-0 

1-0: WHILE 1<30 DO: 1-1 >1: ft (1 )■--"" :ENDWIIILE 
1~0:WHILE 1<5 DO:i = i+l:kt (U-"":ENDWHTLE 

CLEAR SCREEN 

UTD SEVERS E : PRINT "CSG IMS data base creator"; 



GOSUB filename: GOSUB fin Id 
END 



: GOSUB edit 



LABEL flle_name 

NOTE get the name for the file 
REPEAT 

LOCATE IROWS-1,1 :CLEAR LINE : P RINT "Data ba.se name: »; 

UTD REVERSE: INPUT aS : UTD NORMAL 

a$-TRIM$ (aS) 

IF a$<>"" THEN 

GOSUB check_namc 

IF good THEN 

f 1 lename-aS : name good-1 

LOCATE l,35:PRINT~"Name: ";:UTD REVERSE : PR t NT 
fl lename; :UTD NORMAL 
ELSE 

CALL create_error ("Not a valid data base name") 

ENDIF 

ENDIF 

UNTIL name_good 

NOTE get number of records 

LOCATE IROWS-1,1: CLEAR LINE: PRINT "Number of records: 

UTD REVERSE : INPUT a$:UTD NORMAL 

IF TRIMS (a$) <>"" THEN 1 -INTEGER (aS) 

IF 1^-0 THEN 

records-1 

LOCATE 1,62:PRINT "Records: ";:UTD REVERSE : PRI NT 
records; :UTD NORMAL 
ENDIF 
ENDIF 
RETURN 

LABEL flold_name 

NOTE get field and key info 



REPEAT :GOSUB add 
RETURN 



UNTIL NOT good 



Header or Key or 



LABEL add_name 
NOTE add one field or key 
good 0 

LOCATE IROWS-1, 1:CLEAR LINE 
PRINT "Type of field (Regular, 
F.SCope)? "; 
REPEAT 

ft $ -CAPS (GETKEY) 

UNTIL SUBSTR (ft.S, "RliK'MCHRS (27) > 
IF ft$"CNR$ (27) THEN RETURN : END I F 
IF £t$-"K" THEN 
keys-1 

WHILE keys<5 DO 

IF kt(keys)-"" THEN EXIT : ENDIF 

keys-keysU 

EN11WUILE 

IF koyr.>5 THEN 

CALL create_er ror ("Too many keys") 

good-1 : RETURN 

ENDIF 

row-17tkcys;col-l:n-30ikeys 

F.T.SE 

£ lelris-1 

WHILE £ields<30 DO 

IF ft (fields)-"" THEN EX IT : ENDIF 

fields-f ields+1 

ENDWIIILE 

IF f1elds>30 THEN 

CALL create_error ("Too many fields") 

good-1 : RETURN 

ENDIF 

row- ( fields- 1) %15*3:col= (fields/16) »40+l :n-f lelds 

ENDIF 

LOCATE row, col: PRINT n; : LOCATE row, col + 3 : PRINT ftS; 
REPEAT 

LOCATE IROWS-1,1: CLEAR LINE : PRI NT "Field name: "; 
INPUT a$ 

GOSUB check name 
UNTIL good 

LOCATE row,coi*5:PRINT a$; 
LOCATE IROWS-1, 1:CLF.AR LINE 
j PRINT "Data type (Integer, Long, Date, Real or Text)? 

REPEAT 

dt$-CAP$ (GETKEY) 

UNTIL SUBSTR (dtS, "ILDRT") 

LOCATE tow, col) 21: PRINT dtS; 

IF dt$-"T" THEN 

REPEAT 

LOCATE IROWS-1,1: CLEAR LINE 
PRINT "Text length: "; 
INPUT 1 

UNTIL 10 and 1 dO 

LOCATE row, col \2 2: PRINT 1; 

ENDIF 

IF ftS-"K" THEN 
GOSUB getexp 

ELSE eVS> ^ $:kt (koys) ' d, $:kl '^Vs) -1 :ke (keys) -masks 
LOCATE IROWS-1,1: CLEAR LINE 
PRINT "Field mask: "; 
INPUT maskS 
maskS-LEFTS (mask$, IS) 

fn (fields) -a$: ft (fields) -ft$:dt (fields) =rit$ 

fl (fields) -l:fm<flelds>-mask$ 

ENDIF 

LOCATE row, col+26: PRINT maskS; 
RETURN 

LABEL getexp 
REPEAT 

LOCATE IROWS-1,1: CLEAR LINE 

PRINT "Key expression: ";:INPUT maskS 

mask$=TRIMS (mask?) 

UNTIL mask $<>■"• 

RETURN 

LABEL cheok_name 

good-1 :a$-TRlMS (aS) : l^LENGTlt (a$) 
IF Kl OR 1>15 OR CAPS (LEFTS (a$, 1) ) <*'A" OR 
CAPS (LEFTS (aS, 1) ) >"7," THEN 



THEN 



good-0 
ELSE 

WHILE 1 DO 

IF SUBSTR(MID$(a$ f l,l), 
./?") OR MID$(aS,l,l)=" 
good-0:EXlT 
ENDIF 
1-1-1 
ENDWHILE 
ENDIF 
RETURN 



LABEL edit 

NOTE allow changes to any of the data 
LOOP 

LOCATE I ROWS- 1,1 

PRINT "Press N to change file name, F to change 
field, C to create or Q to quit: "; 
REPEAT 

a$-CAP$ (GETKEY) 

UNTIL SU8STR faS, "NFCO") 

UTD REVERSE:PRINT a$;:UTD NORMAL 

IF a$-"N" THEN 

GOSUB file name 

ELSE IF a$-"F" THEN 

GOSUB editfield 

ELSE IF a$-"C" THEN GOTO create 

ELSE RETURN 

ENDIF 

ENDIF 

ENDIF 

ENDLOOP 

IABF.L editfield 
LOOP 

LOCATE I ROWS- 1, 1: CLEAR LINE 

PRINT "Press D to delate a field, A to add or ESCnpe: 
REPEAT 

a$~CAP$ (GETKEY) 

UNTIL SUBSTR(aS,"DA"*CIIR$ (27) ) 
IF a$-"D" THEN 
LOCATE I ROWS- 1,1: CLEAR LINE 
PRINT "Delete which line? 
INPUT 1 

IF 1»1 AND 1<=35 THEN 
IF i>30 THEN 
kt (1-30)—" 

LOCATE 1-11, 3: CLEAR LINE 

ELSE 

ft (1 >-'■" 

LOCATE ((1-1) %1 5+3 , 1/16*40*3) :RINT " 

ENDIF 
ENDIF 
ELSE 

IF a$-"A" THEN 

GOSUB addname 

ELSE 

RETURN 

ENDIF 

ENDIF 

ENDLOOP 

LABEL create 

NOTE save info In a .ide file and create the .Ida anr 
.iln files 

a$-f ile_name+" . Ide" 

SET TRAP TO create_trap 

SET PRINT TO a$ 

SET TRAP TO abort_trap 

SET SCREEN OFF 

SET LEFT MARGIN TO 0 

SET PRINT ON 

PRINT "FILE ".-file name;" OF LENGTH ";records 

PRINT 

1-0 

WHILE i<30 DO:i=i+l 
IF ft (1 )<>"•' THEN 

IF rt(i)-"H" THEN PRINT "HEADER " ; : ENDIF 
dtS-dt (1) :GOSUB printtype 
PRINT fn(i); 

IF dt{I)-»T" THEN PRINT - OF LENGTH ";kl (1 ) ; :ENDIF 
IF fm(i)<>— THEN PRINT ' MASK "'; fm { I );'"': ELSE 
PRINT: ENDIF 
ENDIF 
ENDWHILE 
PRINT 
i-0 

WHILE i<S DO: 1-1+1 
IF kt(i><>"" THEN 

PRINT "KEY ";:dt$~kt(i) :GOSUB prlntt ype: PRINT kn(l); 



IF kt(l)-"T 
ENDIF 
PRINT " - ";ke(D 
ENDIF 
ENDWHILE 
PRINT 

SET SCREEN ON:SET PRINT TO 
SHELL "IMSD " + a$ 
SET TRAP OFF 
RETURN 



THEN PRINT " OF LENGTH ";kl(l); 



:SET TRAP TO imsdtrap 



LABEL create_trap 
SET TRAP OFF 

IF ERR0R=218 THEN NOTE file already exists 
CALL create_error ("File already exists") 
GOSUB file_name 
RESUME AT create 
ENDIF 

LABEL aborttrap 

SET PRINT TO "":SET SCREEN ON 

LOCATE I ROWS- 1,1: CLEAR LINE 

HELP ERROR 

END 

LABEL imsd trap 
SET TRAP OFF 

LOCATE IROWS-1,1: CLEAR LINE 
PRINT 

PRINT "Can't create the .Ida and .lln files because 
of errors found by IMSD." 

PRINT "You can edit the .Ide file to correct the 
errors." 

PRINT: PRINT 

CALL create error ("Press any key to continue") 



LABEL printtype 

IF dt$-"I" THEN PRINT " INTEGER "; 

ELSE if dt$-"L" THEN PRINT "LONG "; 

ELSE if dt$-"D" THEN PRINT "DATE "; 

ELSE if dt$-"R" THEN PRINT "REAL "; 

ELSE PRINT "TEXT 

ENDIF 

ENDIF 

ENDIF 

ENDIF 

RETURN 



MODULE createerror (message) 

LOCATE fROWS,l:CLEAR LINE 

UTD REVERSE : PRINT message; CHRS (7) 

WHILE GETKEY=" " DO ENDWHILE 

LOCATE IROWS,l:CLEAR LINE 

END 



-waiting" 



Using the program 

This program can be executed in several ways. From the 
OS9 prompt, the IMS menu, in CSG IMS interactive mode 
or from another CSG IMS program- 
When the program is invoked, it will prompt you for the 
name of the datafile you wish to create followed by the fields 
and keys. When entering die key expressions no error check- 
ing will be done. If you enter a bad expression, an error will 
be reported when the files are being created. If you do have 
an error you can either edit the .ide file or reenter all of the 
fields and keys and try again 

When the file name, fields and keys are all defined, you 
can create the data base. Te program will call the IMSD 
program to perform this function. Any errors will be reported 
on the screen. 
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Product Reviews 



Clipboard's Review Crew 



Coco Clipboard magazine is looking for 
Color Computer owners with good writing skills 
to assist us in evaluating new products. We 
can t pay you for your reviews, but you will 
have an opportunity to examine new products 
for the Coco, sometimes before the products 
become aval able to the public. You will also 
gut a free copy of the issue in which your 
review appears, and you'll have the satis- 
faction of having helped other Color Computer 
owners with your evaluations. 

If you are interested, write up a short 
sample review of any Coco product (please keep 
th^ length under 700 words) and send it to out- 
review editor, Handy Krippner, at the address 
listed below. Material must be printed (dot 
wutnx is fine). Make sure your name, address 
and phone number are printed on the first 
page of the review. 

Include a description of your computer 
system; which model Coco you own, amount of 
HAM, number and types of disk drives, type of 
printer, what operating systems you have (OS9. 
RS DOS, ADOS, etc.), and so on. 

Mail it to: Handy Krippner, 1014 W. llwy . 
114, Lot 29, Hilbert, MI, 54129. 

If you are selected to be one of Coco 
Clipboard's reviewers, we'll contact you with 
further details. Please include a stumped, 
self addressed envelope with your sample 
rev i ew . 

MiLor's Note: Because of the Length of 
tteveral of this issues article's we nave 
limited our reviews to just two items. Our 
November / December edition will contain many, 
many more reviews - just in time for the 
holiday buying season. We did recieve three 
programs for this edition which are of 
particular note. We will be presenting more in 
d^pth reviews on these programs in up-coming 
insues. 

VIP Database 111 
S.D. Enterprises 
P.O. Box 1233 
Gresham, OR 97030 

Pgm. Type: CoCo III Database 
Requires : 128K CoCo III + Disk 
Price : $69.95 

It's rather unfortunate that. we don ' I 



have more room in this edition for reviews as 
Paul Anderson and S.D. Enterprises have done a 
remarkable .job in creating a nicely updated 
version of a tried and true CoCo database. 
Those of you with the original VIP database 
will be please to learn that 98% of all your 
original commands still work with Database III 
and that S.D. will upgrade your old version 
for $42.95 including postage and handling. 

Some of the enhancements for Database 3 
include compatibility with RGB Computer 
Systems hard disk, 40 or 80 column display 
using the CoCo Ill's internal hardware, DOUBLE 
clock speed, a print spooler and a report 
generator with almost unlimited print format 
abilities and you can embed control codes for 
ALL typs of printers. In addition you can 
easily set the foreground and backround colors 
using the arrow keys to your personal taste. 
We tesLed Database III on a composite monitor 
and even at 80 columns, where a lot of data is 
displayed we had little if any trouble reading 
the screen - especially after experimenting 
with foreground and backround colors. RGB 
monitor owners will be thrilled with these 
capability as well as they can really tailor 
their dispay's look. 

The biggest difference with Database III 
■s it :i ability to sort. The original program 
used a disk sort system and often took many, 
many minutes to do even a limited range of 
sorts. Database III however uses in memory 
sorts and at double clock speed this program 
just roars! Paul provided some sample programs 
for us to test, based on the examples in the 
ViP Database III manual. These examples (you 
can type them in from the manual) show off the 
sort routines (speed and sort order) and the 
built in math package. This makes constructing 
an accounts receivable file very easy and you 
can have the program update your accounts with 
just a couple of key strokes and in ascending 
or decending order. 

Plus you design the database records the 
way you want them, not the way the program 
writer thinks is best. (For detail on what a 
database is, and how you might put one 
together refer to issues 4, 5, 6 of Clipboard 
- available on back issue order). A database 
does not have to be just the Christmas card 
list - it can be any type or set of 
information that needs to be manipulated, 
stored and retrieved. VIP Database 111 
certainly let's you do all of that and very 
quickly. There's another feature, mentioned 
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already, which makes this program particularly 
interesting. It works with the RGB Hard Drive 
system. Depending on the hard drive size, you 
could have from 120 to 250 drives on line 
using the RGB system. Since VIP Database III 
does not do disk sorts - your information flow 
becomes incredibly fast when using a hard 
drive. Your accounts receivble, payable and 
yes your Christmas card list can all be on 
their own "disk" on a hard drive just a few 
seconds away. The database also has mail merge 
capability for form letters with the personal 
touch. Coupled with VIP Writer III, Database 
III becomes a high powered productivity worker 
in your home of office. 



HELLO. BASGOODGAMES TRIO 
Roy Pierce Software 
P.O. Box 1787 
Main Post Office 
Edmonton, Alberta 
Canada 

{403) 474-8435 

Pgm. Type: Disk Utility* 

Skill Games 
Requires :CoCo 2 or 3 
Price :*19.95 each 

A lot of good things have come out of 
Canada for the CoCo - especially out of 
Edmonton. A new source of clever utilities and 
games is Roy Pierce Software. Roy has sent his 



first two releases, HELLO. BAS and GOODGAMES 
Trio. 

HELLO. BAS is a disk menu selector 
program. Now disk menu selector programs are 
not really new but HELLO. BAS incorporates 
several programs that . not only make program 
selection easy but contain a specialized 
DISKINIT/ auto boot initializer, a HELP/ file 
and a DOS BOOT/DAT file. What HELLO . BAS does 
best is go onto your blank disks before you 
load them with more programs. That's what 
DSKINIT/ does. Take a freshly formatted disk 
and then run the DSKINIT/ program. It creates 
a file that will automatically look for 
HELLO. BAS and HELLO. BAS will then let you load 
your programs. 

A HELP/ file is included to walk you 
through the instructions for copying and extra 
drive set ups. The program is powerful in 
it's simplicity and provides a nice menu 
program for each disk you have. Considering it 
can be moved from each disk in your collection 
with ease the $19.95 price is quite low. 

Roy also sent along his GOODGAMES TRIO. 
These are games that Roy originally wrote for 
his own pleasure, but had so many requests he 
went public. These games are ADI , OTHELLO and 
CONNECT5. Well OTHELLO and CONNECT games have 
ben around for a while - but hardly this fast 
and certainly not as cleanly. These games are 
PMODE 4 games so they can go from CoCo 2 ' s to 
CoCo 3. Roy has kept them simple in graphics, 
but fast in speed with nifty little sound 
effects to help you keep track of the action. 
OTHELLO is a subset of the larger version and 
if your familiar with Roman Checkers, a Tandy 
ROM Pak, then you know what OTHELLO is. Roy's 
version uses an 8 x 8 board as opposed to the 
larger 12 x 12 board. This keeps the action 
fast paced, especially when used by younger 
players who could tire from the larger 
version. More experienced players face a 
greater challenge with the smaller area, kind 
of like putting the Chicago Bears into an 
arena football field, or making Larry Bird 
play half court and telling them they have to 
play for the championship. 

CONNECT5 is great for kids as it is so 
similar to other connect type games. Black and 
white discs drop from the top with a quick 
little sound and snappy animation. Connect 5 
disks in a row and you win. 

ADI is a game that you probably haven't 
heard of before. And it's not one that will 
come easily for many of us with a traditional 
western game mind set. This game comes to us 
from Africa. It was originaly played in the 
desert sands using handy playing "chips" from 
a natural source. Now if you don't know what 
that means buy the game and read the 
instructions. The game is played on a board of 
12 slots in two rows of six. The object of the 
game is to move your tokens around the board 
so that you cature the enemy but also defend 
your positions. It looks a lot like 
Backgammon, but plays without dice, or bets, 
or many of the rules of that game. Being born 
in the desert there wasn't a lot of time for 
rules in games, or dice cups. Things often had 
to be packed in a hurry. One thing you will 
find in this games is strategy. I never knew a 
caravan that didn't have some pretty tricky 
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A DISK DIRECTORY UTILITY 

Display Alphabetically Sorted Directory of 

any Drive. (0 3) 
Print a Hardcopy ol Sorted Directory w/Date 

and Disk Name. 
Dun ANY BASIC Program with Ease. 
RUNS ON ANY COCO. 
(32K Disk Extended BASIC Required) 
Single Key Stroke Commands. 



A\ (§! 

r \\ Vv :: V 

by Roy C. Pierre (<:) I9R8 

Easy to Read Display. 

ALL BASIC so il won't Mess up your System. 

SUPER FAST OPERATION. 

Reads Any Drive at Will. 

Low Disk Overhead Only 1 Gran. 

Easy to Copy to All your Disks, Comes with 

Handy DISKINIT/ Utility lor 

Autobooting HELLO/BAS. 



Challenging Two Player Gam« 

ADI OTHELLO 



§) inn 

by Roy C. Pierce (c) 19B8 

CONNECT 5 

FAST AND FUN FOR ALL AGES 
EASY TO RUN 
ALL BASIC COMPLETELY L (STABLE 



INDIVIDUAL ORDERS $19.95 U.S. $22.95 CDN. 
INTERNATIONAL $22.95 U.S. 
RETAIL AS IS 

SHIPPING & HANDLING INCLUDED 



RCPlERCE 
SOFTWARE 



P.O.BOX 1787, 

Main Posi Office. 
Edmonton, AB. Canada 

T5J-2P2 
PH: (403) 474-8435 



C'onimucd Itoiii -i 

they want, wi Lh the programs they want. 
Variety is the spice of life and the CoCo is 
really the only "spice" on' the Radio Shack 
shelf. It's simple, low cost, friendly, well 
supported and CoCo owners are just plain GREAT 
people. 1 am getting into "Tandy bashing" with 
all of this? No, not at all. The Tandy PC 
Clones and the new OS/2 5000 MC are too flitfht 
PC machines. But they aren't the only kind of 
computers people want or need. All I'm trying 
to say is give the CoCo the respect a tried 
and tested veteran deserves. Give the customer 
the chance to determine the market and the 
machines they want. Stop hiding the CoCo over 
in the corner, next to the tube tester. 

The beat thing I saw coming out of Tandy is 
the Express Order catalog. Now you can do the 
ordering directly from Tandy, on an 800 num- 
ber, and have the product sent right to your 
home. While this might take a customer out of 
the retail stores, it sure makes it easier to 
buy, and the store manager has one less thing 
to handle among the thousands of regularly 
stocked parts. Somebody was listening to 
people's needs in this area and we think Tandy 
made the right moves in this direction. 

Speaking of listening, I wish you'd make 
note that our advertisers need your support. 
When you make a purchase from one the fine 
folks who help support us please mention 
Clipboard or use the coupon on the coupon 
page. These hard working people will really 
appreciate your purchases and we all benefit 
by getting more out of our computers! 



dealers and players and this is the game that 
came Iron them. It looks simple, but you 
better put on another pot of "joe" before 
sitting down to a serious game of ADI ! 

There is a built in help file with AOI 
plus a (L)ook command that will let you peek 
ahead if you're really stuck. 

At a little over $6.50, which includes 
that postage, the GOODGAMES Trio is well worth 
the price. 



******************************************** * 
We* Now Accept % 




RAINBOW 



If You Are Serious About Stocks. 
This Program Is A Must! 



Stock Market portfolio for the color computer 
will keep track of all your current stock listings 
and keep a listing of stocks you have sold by the 
year, they were sold with all totals, profit and 
loss, and percentages. More than one person 
can use this program as long as the first three 
letters on both first and last name are not the 
same. The program is menu driven and will 
give you the option for either screen print or 
information to be printed on printer. 



Rush Check for $22 00 plus $3.00 shipping &. handling to: 
Paparis Enterprises 
700 York St. 

Williamsburg, VA 23185 
Please allow 2-3 W€eks for delivery 
Sorry no CO.D.S 
VA residents add 4.5% sales Km. 

sfsSSSSSSSSSSSSSSS SSSSSSSSSSSHttSSSSHSSSSSS SSSSSSSSSSSSSfl 



¥ F* o r Your * 

t ^ li bscr i jf> AX^ i c> ri and % 

t * 

¥ ClipDisk Orders * 

t * 

* (716) 679-0126 9am to 9pm Eastern J 

* Monday thru Saturday { 
************************************************ 



E t tt. r- c J U i a It O i~ £j£ tm i zer 
(11. U . O . ) 

<l> HDU can help yuu choose and execute 
your various appl ication programs 
<Z> You manke Mentis and Scripts - HDD will 
do the work 

<J> It' your system has the capacity, you can 
reach 2 mi LI ion programs in just 8 
keystrokes 

<4> Indiv iduals with no knowledge of OSif 

are able to use your programs 

<5> MX) has been successfully run on both 

the CoCo & 6tih 0S9 Systems 

<6> HIM) supports multiple terminal 

configurations 

******************************* 
Sample Menu: 

Hard Disk Organizer Sytitow 

1. Development of riles 

2. Busi, & Word Processing 

3. Couuauuicti Lions Progruus 

4. Exit 

* **************** ******* ******* 

The li.D.O. program is available from: 
Bob Hongs tebeck, 108 draudv tew Ave., 
Feasteiv tllv, PA 19017, (Zlb) HHH-S-ISo 

HALO, is just $24. l J5 + $.i.00 shipping and 
packaging. 



Please renew my subscription for 1 year - 
enclosed is my check. Great magazine, Thank 
you ! 

Dave Kincaid 
Greenville, SC 



Gosh, Dave what could I add? Thanks! 



Out of the blue I received Vol I. #5 of 
your magazine in the mail yesterday. A quick 
scan was enough to persuade me to subscribe. 
Inclosed is my check for subscriptions and 
back issues Vol 1. #2, 3, and 4. 

I was also pleased to read of your con- 
nection with CompuServe as I am a member 
(76672,03646) and I'm looking forward to the 
conference . 

T. Eric Nelson 
Santa Rosa, CA 

Our monthly conferences co-sponsored by 
Cl ipboard and Dan Robins from Computer Shopper 
are gaining in popularity. In August we had 
Paul Anderson from S.D. Enterprises . 
September we tentatively have Chris Burke from 
Burke A Burke Hard Drives, and October's CO 
will feature Roger Krupski from RGB Computer 
Systems ! 



Inclosed is my check for issues 1, 2, 3 and 
4. I and my grandchildren are operating 6 CoCo 
64k's. The children range in age from 4 to 12. 

I run 0S9, Pascal, C and Basic09. I sent 
for Bill Bernico's disks and use them in 
creating Ed. programs for the kids. From what 
1 see in Vol. 1 #5 you have the startings of 
an outstanding magazine . Keep up the good 
work. 

When I get my retirement check next month I 
will extend my subscription two more years. 
Here's to many happy hours on the CoCo ! 

Donald M. Tidd 
Vallejo, CA 



We're impressed Don. Just goes to show that 
young and old love their CoCo's. Thanks for 
writing! 



Congratulations on a great little magazine. 
I look forward to receiving many more issues. 
Enclosed is my check to extend my subscription 
for two more years. 

James L . Gifford 
Kingman, AZ 

Jim it's folks like you who brighten our 
day! 



Please find enclosed a money order for 9 
subscriptions to your magazine. All these 
subscriptions are from members of the London 
CoCoNuts Computer Club, and we were made aware 
of your magazine through our contact with the 
Toronto Color Computer Club. We are definitely 
looking forward to the success of your 
magazine . 

Wayne Morrison and eight others 
London, Ontario 

Wayne: Boy did Dar and I flip when we got 
your letter! Thanks for the great support and 
I hope you're enjoying your copies. 



I was impressed with your Jan/Feb. issue. 
The future of the CoCo is OS9 and MultiVue. I 
recommend that you include routine articles 
and tutorials on OS9, Basic09, "C" , and 
MultiVue programming. We need an article 
comparing the features of the various hard 
disk systems that are available. We need 
reporting of inside Tandy info and rumors. 1 
think you have a bright future if you pattern 
your approach after PC M agazine. We need 
this type of periodical for the CoCo 
community. Keep up the good work. 

James Neukam 
Owensboro, KY 



Well we've got the "C" column going for you 
Jim, and two columns dealing with Basic09 
(actually 3 this month) and Randy Krippner is 
working on a MultiVue project for the next 
edition. I'd love to publish more about our 
friends at Tandy, but only when we can get - 
as Joe Friday would say ~ the "facts, " We 
encourage all of our readers to write to Tandy 
and tell them how ( much you like the CoCo and 
want more hardware and software and support 
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Glad to see the CoCo working hard in such 
an important place as your halfway house. 



Here is my check for renewel of my 
subscription for 2 year. Much of the contents 
are way over my head but 1 hope to have time 
to learn some of the intricasies - and PLEASE 
don't neglect the CoCo II owners who don't 
want to invest is OS9 ! I'm still producing a 
newsletter for my husbands WWU outfit and use 
2 CoCo's, 3 printers, 2 SS drives. 

Mar ied A Bickers 
Ou l.f Breeze, Ft. 

Per your request find our new series on 
modular programming in Basic by Bosiy Pitre, 
plus a Basic program by Hike Dooley. We're 
working on more "good" programs and articles 
for the CoCo 2. 



Here's my money order for the timely 
reminder to renew. I enjoy the magazine very 
much and have recommended it to quite a few 
people here in Toronto. 

Keep up the good work, I enjoy it all. The 
ocassiona] hardware interface etc. would be of 
interest also. 



program in one issue only to find out that 
you've got to wait till next month, or pick up 
the disk service to get the balance of the 
article when you get to the end of the piece. 
We said up front, that the article would be 
split and we have part 2 of the article in 
this issue. 



Enclosed is ray check for a 2 year renewel. 
Keep up the good work. Your's is one of the 
few magazines that I read cover to cover - 
every article seems like it's written just for 
my level of knowledge. Keep up the "C" 
support. I know there's a wealth of knowledge 
available in this language and your articles 
are helping me tap this great source ( that's 
a pun!). Try to get "C" running on MultiVue. I 
love hearing about others who use their CoCo's 
for business reasons. I hope to be able to do 
this soon. And where is Rush Caley? 

As long as you treat the CoCo as more 
than game machine, I'll be subscribing! 

Stephen A Houghy, MB 
Milwaukee, Wl 

So you like reading about CoCo business 
success stor ies??? Check out our contents page 
and thanks for your support! 



Mike Fisher 

Toronto, Ontario Canada 



Mike thanks for the help in Toronto! Our 
readers should note that on the top of their 
mailing labels we are now publishing the start 
and ending dates of their subscription. The 

ending date is fine month BEFORF. your 

subscription expires. Questions on 

subscriptions are welcome at our Fredonia 
offices, Monday through Saturday from 9am to 
6pm eastern. 



1 would like to renew my subscription to 
this wonderful magazine. My check is enclosed. 
Thank you and all your staff for a great 
magazine. Keep up the good work. 

Ed Robinson 
Fresno, CA 

Thanks Ed! 



1 would also like to compliment you on your 
magazine, I think it was a much needed 
improvement in a lot of areas as far as the 
CoCo goes. I also like the fact that you are 
trying to put full programs into the magazine 
instead of trying to stretch them out over a 
period of months. Keep up the good work. 

Bave Henderson 



Dave, we really debated about running Randy 
Krippner's program over two issues. We dislike 
articles which seem to promise an entire 
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I have included a money order for one year 
of CoCo Clipboard Magazine and two of the back 
issues. I would like to have issue 4 
March/April 1988 and issue 5 May/June 1988. I 
would like to have all of the back issues but 
I think that your price is a little high for 
pho tocopi es . 

Continued On 36 

************************************************ 
+ * 

t brEcIAL SALE r ROM BILL BERN l CO SuFl whRE ! J 
{ BUILD UP YUUR SOFTWARE COLLECT ION WIlH * 
t THIS FANTASTIC OFFER. YOU SET MORE ThAN jj 
$ 250 PROGRAnS (ABOUT 75 OF THOSE ARE FOR * 
t 1 HE NEW COCO 3) ALL FOR 1 HE LOW PRICE OF * 

* JUST 421.00. PROGRAMS COriE ON FOUR DISKS * 
+ ALL DuUBLE-SIDED AND PACKED WITH 600DIES * 

* FOR YOUR COLO 1,2, & 3. \ 0U ' LL uET MUSIC * 

* GRAPHICS, TUTORIALS, ED1CATIUNAL, bANES, J 

* UTILITIES, PRINTER, HONE HELP, DAI ABASES J 
{ DO /ENS OF SUBROUTINES THAT YOU CAN USE I 
J IN YOUR OWN PROSRANS, LOTS OF FONTS FOR * 
t DISPLAYING TEXT ON 1 HE SRAPHICS SCREEN, * 
t DISK PROSRANS AND EVEN A WuRD PROCESSOR! * 

* SEND CASH, CHECK OR HONEY ORDER (U.S. S 
J FUNDS ONLY) . I'LL EVEN FAY POSTAGE AND * 
+ HANDLING. ALL YOU PAY IS $21.00 - PERIOD + 
J SEND FOR YOUR SOFTWARE C0CLECTI0N TODAY: J 

: I 

* BILL BERN I CO SOFTWARE * 

* 70S Hi CHI SAN AVENUE { 

* SHEBOYGAN, Wl 53061 t 
£**************$********************** ********** 



SEEC: To Define 



Nancy Ewart 



The easiest part of starting a new 
language is understanding the language; the 
hardest part is putting the environment to- 
gether and knowing step-by-step how to use it. 
In the beginning all I knew was I needed OS-9 
and a C Compiler to learn to program in C. 
Because of this vast ignorance, I followed 
anything that had steps, or samples, that I 
could find. I quickly learned to do EXACTLY as 
they said, and not try to improve on anything. 
Therefore, it took me too long to start 
fiddling with the compiler, the libraries and 
such. I hope that the exercises, examples and 
explanations in this essay will make it easier 
for others to start such fiddling sooner and 
with more understanding. 

One of the most important concepts to un- 
derstand for those of us who are not ex- 
perienced in assembly language is how the C 
Compiler works and what influence the C 
Compiler has on the use of the language. This 
time we will explore the PREPROCESSOR; with 
♦include; ♦define; libraries; and the command 
line of the compiler itself. 

Frequently #define is used for the con- 
stant to identify the number of elements in an 
array. This practise helps you remember what 
the source code was all about six months 
later. 

Idefine BOX_SIDES 6 
Then later you can set up an array thusly: 

int caskets [ BOXSIDES J 

When you use f define, the Preprocessor 
changes every instance of the defined symbol 
(string) into the definition; for example 
♦define PI 3.14159 or fdefine HELLO "Hi, 
there! What's New?". It makes all these sub- 
stitutions throughout the source code before 
the compiler even begins passl. Consider the 
following source code: 

/* Preprocessor exercise one*/ 
fdefine BEGIN main( ){ 
idefine END } 
Idefine PRNT printf(" 

BEGIN 

thirty(); 

PRNT Book Trader\n"); 
twenty ( ) ; 

PRNT Quality Preowned Paperback Books\n" ) ; 
thirty{ ) ; 

PRNT Half-price"); 
END 



thirty( ) 
{ 

printf(" "); 

} 

twenty( ) 
{ 

printfC 

} 

You can send the source code through the 
preprocessor only; thus you stop the compiling 
and look at what is happening. Use this com- 
mand : 

c.prep -1 btlogo.c >/dO/WORDPR/btprep 
where WORDPR is a directory on drive 0. Then, 
list btprep. 

BTPREP (exerpt) 

16 

idefine BEGIN main( ){ 
♦ 6 

Idefine END } 
16 

♦define PRNT printf(" 
16 

#5 

4 

16 

BEGIN 
main( ){ 
16 

thirty( ); 
thirty( ) ; 
#6 

PRNT Book Trader\n"); 
printfC Book Trader\n" ) ; 
16 

twenty( ) ; 
twentyj ) ; 
16 

PRNT Quality Preowned Paperback Books\n n ); 
printf(" Quality Preowned Paperbac Books \ n ") ; 

And so on You can see what is 

happening. Did you notice that the prepro- 
cessor dropped off the "k" in "Paperback"? The 
♦define PRNT printf(" has a number of sur- 
prises for the unwary; the "k" was the 
character that wrapped around to the next line 
on the VDG screen. For this reason, change the 
line PRNT Quality* (etc.) to the regular 
printf ("Quality (etc.) and then compile it and 
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you will get the Book Trader signature the way 
it was meant to be. Another limitation ia 

that there must be a apace between "PRNT " and 
what you want to print or the compiler will 
treat it as one word and announce an unde- 
clared variable. However, when #define PRNT 
works it saves a lot of shift key typing. 

All this playing around with the #defines 
is not much of a time saver with programs as 
simple as these. Where #define comes in 

handy is for something that is used over and 
over again, either in one program or in many 
programs. In the latter case, expand the 
#defines to include all the helps and short- 
cuts that you need. Put them in an .h file 
such as lazy.h and # include them at the 
beginning of all your programs. Here are a few 
inclusions to start your thinking. By the way, 
the part of the #define directive in CAPS is 
called the "macro" and the definition is 
called the "replacement string." 

lazy . h 

tdefine BKOIN 

# define END 

# define PRNT 

#define TIMES 

tdefine IF 

# define THEN 

lilefine ELSE 

tdefine AND 

tdefine OR 

tdefine EQUALS 



main( ) { 

I 

printf ( " 



if ( 



e l se 
A* 



progrum2. If optimizing were actually done, 
program! will be shorter. 

Donald Hicks of 355 St. Emanuel St., 
Mobile, AL 36603 was the first to write in 
with this suggestion for the C Compiler in a 
Level Two environment: 

The LIB and DEFS files from the 
Development Pak should be added and, since 
there are some differences, "c.asm" should be 
replaced with a renamed copy of "rma" and 
"clink" with a renamed !, rlink" from the same 
source . 

He also suggested this fix: 

In "ccl" starting at offset $0EE6, change: 
/d0 /lib/ctart to /DD /lib/cstart (or 
whatever suits you) 
In "cprep" starling aL offset $J35D, change: 
/d() /dofs/.r to /DD /defs/.r (or 
whatever ) 

Donuld suggests using a disk file editor 
to do this job. He emphasizes "Notice the 
space after the device name. It must remain 
undisturbed. It is actually a $00 byte, as is 
the one before the device name." 



The following could be the start of 
something to amuse a five year old, joke.c 

t include "lazy.h" 

tdefine KK Knock, knock\n" 

BKGIN 

PRNT KK ) ; 

PRNT Who's there?"); 
END 



In addition to the ability to look at 
what the preprocessor does as described above, 
you can use the options available for the 
compiler command line to save yourself time, 
when debugging and, finally, space, when 
storing compiled programs. You can cut down on 
the time involved when working on debugging C 
source code by omitting the code optimizer 
phase of the compiling process. The command 
line is ccl -o joke.c. (REMEMBER, clear away 
the debris from an aborted compile, i.e. 
ctrap.3.m, etc., before starting a new one.) 

On very simple, short programs the -o 
option doesn't seem to make much difference 
one way or another, but on longer programs if 
you skip c.opt, the compilation is faster. 
At the very end, when everything is A-OK , run 
the compiler one last time, leaving c.opt in. 
The optimizer will make the code more ef- 
ficient and shorter. Make a trial run by 
giving the same source code two different 
names (programl.c and program2.c); compile 
programl.c with the -o option; compile pro- 
gramme straight. Then dump program! and dump 



FILE TRANSFER UTILITIES 

You asked lor il a\ the Chicago RainbowF act - 

FILE TRANSFER UTILITIES NOW HANDLE RSDOS WSKSI 

N*ed io transfer text H« to and Irom PC (MSDOS), RSDOS and FLEX disks into 
your CoCo (OS-9) system? Have tax! files on a PC (MSDOS ) system ai work and 
want to work on Iriem at home on your CoCo? 

With GCS File Transfer Utifities you |ust place the PC (MSDOS), RSDOS or FLEX 
disk into your CoCo disk drive - enter a simple command and the lite is copied into 
a CoCo OS-9 lite. File transfer back to PC (MSDOS). RSDOS and FLEX disks s 
just as simple. 



PCDH 
PCDUUP 
PCHEAD 
PC WRITE 



dnectory of PC disk 
disp'ay PC disk sectc 
read PC (Ike 



RSWRtTE 



directory of RSDOS disk 
display RSDOS disk sector 
read file from RSDOS disk 
wme file to HSDOS dek 



PCRENAME rename PC file 
PCDELETE delete PC file 
PCF0RMAT format PC d.sk 



FLEXDIR directory ol FLEX disk 

FLEXDUMP display FLEX dek sector 

FLEXREAD read FLEX file 

FLEXWRITE witte file to FLEX d*k 



Extensive 
Options 



fi&quires 



Single, double sided disk*. 40 or 80 track floppy drives. 
8 or 9 sectors First level sub-directories - PC (MSDOS). 
FLEX transfers binary files also. 

OS 9 (Level 2 lor MurirVue), 2 drives {one can be hard), MultiVue 
tor MultiVue version, SDISK (SDISK3 lor MultiVue) - see D P 
Jonrison ad lor SDISK 



GSC File Transfer Utilities (or CoCo - MultiVue version $54.95 
GSC File Transfer Utilities for CoCo - Standard version M4.95 



All alettes are CoCo OS-9 formal. Orders must be prepaid or COD. VISA./MC 
acc&fjtud. add $ 1.50 54 H. additional cnaroe for COD. 



GRANITE COMPUTER SYSTEMS 

Route 2 Box 445 Htlteeoro. N H 03244 RAINBOW 
($03)464-3650 timiFicMion 



William A Lathan of 1023 Courtney Dr., 
Mesquite, TX 75150 sent this patch to change 
where the C Compiler looks for the C Library - 
a ram disk instead of drive one. 

J ccl 

c 0ee5 64 72 
c 0ee6 31 30 

V 

1 c.prep 

c 135c 64 72 

c !35d 31 30 



I tried this and it works. For those of 
you who have never done anything like this 
here are the steps to follow: 

First: Be sure you have used tmode pause so 
that you get a screenfull at a time 
and no more. 
Second: Dump ccl then dump c.prep. Find the 
address and look at what you will be 
changing. 

Make Bill Lathan ' s file (nee above) 
using any editor or "build". 
Call it "rampatch". 
load ccl and c.prep into memory. 
Type the command 

modpatch rampatelKentcr > 
Sixth: Rename ccl and c.prep in your CMDS 
directory. This is to protect 
what you have in case of accident. 
Seventh: Save the modified ccl and c.prep from 
memory into your CMOS directory on 
your /dO disk. Save /dO/cmds/ccl ccl 
"Save" is a CMD in bevel I; it does 
not come in Level II unless you have 
Development System. 



Third: 



Fourth 
Fi fth: 



Now you need a Ramdisk call 
Format /r0 , Transfer your C Library 
your C Compiler CMDS directory to the 
You can do that using "dsave" or a 
like "dup" supplied with the Spectrum 
IF you first make a Library diskette w 
the C Library files on it AND a CMDS d 
that includes the C Compiler commands, 
it this way you must have a double 
track format.) 



ed /tO, 
disk and 
ramdisk . 

command 
Rnmdi sk, 
ith both 
i rectory 
{To do 
sided 40 



Bill La than has a different approach. He 



says : 



(This) lists the procedure file 1 use when I 
Play around with C. The library is the one I 
downloaded from CompuServe ... more capability 
than the one by Mioroware. Also, CompuServe 
has CC, an alternative to CCl . 



* This is a file to start the C system with 

* the libraries on ramdisk, /r0. The LIB 

* and DEFS files, normally expected on /dl , 

* are first moved to /r0. The new cc from 

* CompuServe is loaded. Then, the modified 

* command c.prep is loaded as are the nor- 

* mal commands c.passl, c.pass2, c.opt, rma 

* and rlink. 



echo Use rdrsk 24 to set up Ram Disk 
echo Copying C LIB files 
makdir /r0/LIB 
chd ZrO/LlB 

Copy #20K /dl/LIB/clib.l clib.l 
Copy #20K /dt/LIB/cstart.r cstart.r 
echo Copying C DEFS files 
makdir /r0/DEFS 
chd / rO/DEFS 

Copy #20K /dl/DEFS/arg.h arg . h 

Copy #20K /dl/DEFS/bool .h bool.h 

Copy #20K /dl/DEFS/ctype.h ctype.h 

Copy #20K /dl/DEFS/dir.h dir.h 

Copy #20K /dl/DEFS/drrect.h direct. h 

Copy #20K /dl/DEFS/errno.h errno.h 

Copy #20K /dl/DEFS/lowio.h lowio.h 

Copy #20K /dl/DEFS/math.h math.h 

Copy #20K /dl/DEFS/memory.h memory. h 

Copy #20K /dl/DEFS/raodes.h modes. h 

Copy #20K /dl/DEFS/raodule.h module. h 

Copy #20K /dl/DEFS/os9.h os9.h 

Copy #20K /dl/DEFS/password.h password. h 

Copy #20K /dl/DEFS/phone.h phone . h 

Copy #20K /dl/DEFS/scistat.h scfstat.h 

Copy #20K /dl/DEFS/setjmp.h setjmp.h 

Copy #20K /dl/DEFS/sets.h sets.h 

Copy #20K /dl/DEFS/sgstat.h sgstat.h 

Copy #20K /dl/DEFS/sgtty.h sgtty.h 

Copy #20K /dl/DEFS/signal.h signal. h 

Copy #20K /dl/DEFS/stdio.h stdio.h 

Copy #20K /dl/DEFS/string.h string. h 

Copy #20K /dl/DEFS/time.h time.h 

Copy #20K /dl/DEFS/utime.h utime.h 

echo Loading C CMDS into memory 

load /dl/cmds/cc 

load /d 1 / ends jnod/c . prep 

load /di/cmds/c.passl 

load /dl/cmds/c.pass2 

load /dl/cmds/c.opt 

load /dl/cmds/rma 

load /dl/cmds/rlink 

link cc 

link c.prep 

link c.passl 

link c.pass2 

link c.opt 

link rma 

link rlink 

echo All C files and commands have been moved 
echo Do "chd /r0" for C work 

Thanks to Bill's listing, you not only 
know the format for such a transfer of 
material to a ram disk, but you also know 
what is contained in the C Library on 
CompuServe . 

Another source of material to supplement 
the MicroWare C Compiler is the OS-9 Users 
Group Library. For those commands in the 
Library that are written in C, the UG Library 
includes the source code. In addition, there 
are two special C disks: #26 C Language Math 
Library and #09 C Programmer's Tool Kit. 

The OS-9 Users Group sells its User Group 
Library disks for $6 (after you become a 
member of the OS-9 User Group for *25 a year. 
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Finally 



An answer for America's dying teens! 

For your free copy of this dynamic and 
powerful book, call us today at 
1-800-VtCTORY . 




Also; 

See and hear young people who have 
already found the answer at 
Freedom Village, USA in Lakemont, N Y. 

Check your local Christian 
radio and television stations for the 
Victory Today program. 
For more information write 
Freedom Village, USA Lak emont, NY 14857 



OS-9 Users Group 
Suite R-237 
1715 East Fowler Ave. 
Tampa, FL 33612 

Next issue, among other things, I'll give 
a report on FoxWare'a CCENV(R), a mouse and 
menu driver for OS9 compilers. 

I thank every one who sent letters after 
the first column. I urge all of you, beginners 
SOURCE P CODL alike ' t0 86nd ^ -«"»on. and 
Send to: 



Nancy Ewart 
Book Trader ( SEEC ) 
1789 Hooper Ave. 
Toms River, NJ 08753 



Coniii, 



d ho 



Well the NFL Buffalo Bills have their 
training camp here in Fredonia and it's time I 
wrapped up this column, I've got to go over 
and give quarterback Jim Kelly a couple of 
pointers... yeah right! See you all in 
October ! 



SPECIAL DEAL ON 500 
PROGRAMS IS BACK! 



COOL DOWN TO OUR SUMMER PRICES 
ON SUBSCRIPTION SOFTWARE 



BACK BY POPULAR DEMAND! GET OUR LATEST 
50 DISKS OR TAPES FULL OF OVER 500 PROGRAMS 
HERE IS WHAT YOU'LL RECEIVE: 

★ Over 250 Utilily/Home Application Programs including a 
Word Processor, Database, Spreadsheet, Disk Utilities. 
Business Software, Electronics Series, Educational Pro- 
grams for Kids, plus much more! 

★Over 200 exciting games including King Pede, Kron, Star 
Trek, Flight Simulator, Wizard. Horse Races, Football, plus 
much more. 

★ Over 30 adventures including Rambo, Haunted House 
Power Sword, Skid Row, plus 32k graphic adventures. 

Individual issues sell for *9°° each or »450"° 
for all 50. We slashed the price to 
only M50 00 ! 



REG. M50 



$ 150 



★ ★THIS MONTH ONLY*^ 



Buy this package of 500 
programs and receive a free 
6 month subscription. 



RAINBOW 

CERTIFICMION 



THERE IS NO BETTER WAY TO ENJOY THE SUMMER THAN 
TREATING YOUR COLOR COMPUTER TO 10 READY-TO RUN 
PROGRAMS EACH MONTH. GET 12 DISKS OR TAPES A YEAR 
CONTAINING OVER 120 QUALITY PROGRAMS A SUBSCRIPTION 
TO T & D SOFTWARE CONSISTS OF 10 READY-TO-IOAD PRO- 
GRAMS DELIVERED BY FIRST CLASS MAIL EVERY MONTH 
NO, WE ARE NOT THE SAME AS THE RAINBOW ON TAPE IN 
FACT, MANY SUBSCRIBERS HAVE WRITTEN IN AND SAID THAT 
WE ARE MUCH BETTER THAN RAINBOW ON TAPE! 




PRICES 

TAPE IhiS 
OR DISK MONlMOfJL' 
IYEAR(12Imuh) .WOO' 60 00 

6MO.<6l»*ul») MXXf 35 00 

I ISSUE _» <W 8 00 

Micliujaii ResiJenls Add 4\ 
Oveisejs Add $10 lo Subscuphon ^nce 
Peisunai Ctiti-kj. kVultumu 1 



A Available on COCO 1.2, and 3 

* Includes Docui I iui i lalion 

* Over 4.500 Salisf.ed 
Customers 

* Back Issues Available Fiom 
July '82 (Over 720 Piogtams) 



PLEASE SPECIFY TAPE OR DISK 



T&DSUBSCRIPTION SOFTWARE, 2490 MILES STANDISH DR., HOLLAND, Ml 49424 (616) 399-9648 




CoCo Clipboard Magazine 

BACK ISSUES 

Get all 6 
for only 120.00 



Vol. J Issue 4 March/April 1988 
P;iseal Programming 

by Oclrnar Sr.arlcs 

The 9th. Power 

b) R.iiufy Krippner 

Basic Help 

by Bill Bernico 

A Better Display 

by Jim DeSr.ifcnr) 

DataBase Tutorial Pi. H 

by Riiili C'ufry . 

Pi orluct Reviews 

by [>.,„) Borne mann. Lee f aikcr, Ted Paul 

I lie Assembly Line 

by Kinig Qrodtjchmtdl 

C.'oCn 'N Amateur Radio 

by Mike Doolry 

BUST for BAS1C09 

bv Bob <.an At Pod 



Vol. 1 Issue 5 May/.Jutie 1988 



iJaiallase lulorial E*l. IM 

l-j NC .lt, 

I In H:isit Idea 

hyR:.,.Jj Kiifpocr .. 

Maslur Bask 09 

Iv, fllll Brady 

Basic Help 

>jy 1)11 Flernico 

VoCv 'N Amateur Radio 

by Mile I>o..1,-y KFtl'f; 



Qtiitk Forecasting 

by lim hcSisfcno 

Line Input with Editine (DaikOV) 

by Bob i.iwlei fori 

I*i odoct Heveiws 

by R»l,>!. Dahlgren md Mi>r IJuoley 

The "Wegert Report" 



Back issues of CoCo Clipboard are 
always available. The price is $2.75 
per issue (U.S. funds please ) . There 
is a $1.00 p/h charge for the first 
issue ordered and $.50 p/h for each 
additional issue purchased. 
And now you can phone in your order! 
We accept VISA, MasterCard and 
Discover - (716) 679-0126 - 9am to 9pm 
Monday thru Saturday! 



Vol J Issue 6 July/August 1988 

The Wegert Report by Steve WVgrii. 

< oCo and Small Business by Tcny Simons 

('<>«» 'N Amateur Radio by Mike Cooky Kt u e 

Master U»sicQ9 by Bill Brady 

New Boots by flob van der Pod ... 

The Assembly Line by Knig Elimtuhmi,]! 

Programming Challenge by Ted Pj.,1 

Hie Machine SllOppe by Andtew Baucis 

Product Reveiws by Clipbnanh i»-vi e * c ie» 

"SFKC" tor "C" by Nancy F.wan 
Pehixe Rower (iraph by Randy Kiippiw 



Also Available 



Vol. I Issue 1 Sept /Oct 1987 
Vol. 1 Issue 2 Mov./Dec 1987 



Vol. 1 Issue 3 Jan./f eb. 19B8 

Please send a check 
order <U.S. Funds) 



Photocopy 
Photocopy 
Photocopy 

or money 



Orders may be sent to: 
CoCo Clipboard Magazine 
3712 IJ.S', 20 Bay. 3 
fr ciloni a, M. Y. ] 4P);,3 
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the Machine Shoppe 



Andrew Bartels 




Q: What 's the difference between JSR and BSR 
in Assembly language? They seem to do the same 
thing. 

Gene Newkirk 
Richmond, Virginia 



A: Both JSR and BSR perform the same basic 
Amotion. It is the way it is accomplished 
that makes them different. When you use JSR, 
the ML code for JSR is followed by an absolute 
o i r III' a pointer to the appropriate address. 
But BSR works by means of offsets. The BSR 
code is followed by a one byte offset which is 
used to point to the correct address. The PC 
register always holds the address of the next 
instruction to execute. This one byte offset 
is added to PC to form the address to branch 
to. The offset is signed, so you can BSR to 
any routine within -128 to +127 bytes away 
trom the instruction after the BSR. If the 
routine you want to BSR to is further away 
than that, use LBSR, or Long Branch to Sub- 
routine. It ia the same as BSR, except it uses 
Z<XVx* 7 off8e L t f°r a range from -32 768 to 
+32767, or anywhere in the 64K memory work- 
space . 

Why are there two ways of calling a 
subroutine? Well, BSR and LBSR are used gen- 
erally in ML code which may have to be placed 
m a different location from time to time. 
4 7nnn 8e Z° U * ML P™*™* from $E00 to 

9/000. If the program has JSR' s in it, the 
absolute address pointer will still point to 
the old subroutine address. But with BSR 
everything is relative to the PC register, or 
in other words, the location of the program. 
The BSR and LBSR offsets will not be wrong, 
because the program's subroutines will still 
be the same distance from the BSR point. 

But BSR and LBSR are not the only PC rel- 
ative instructions. A truly position inde- 
pendent program must have ALL references to 
offs'ltl* addrGBSeS el i*i™ted and replaced by 

Thus, as you may have guessed, there are 
ways of uaing offaets when loading anrf stori 
to memory, etc. Please see Bill Barden's book 
entitled TRS-80 Color Qsmjnut^ jssemhXx 
Language Programming, pages 223-225 for a 
more thourough explanation about relative 
addressing . 

Q: I am making a program that uses the PMODE4 
graphics mode with artifact colors. I want to 
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make sure the colors come out right when the 
title screen is displayed. Sometimes the 
colors are reversed. Is there some kind of 
value T can store in an address to get the 
colors to come out right? 

James Perry, 
Louisville, KY 



f\l re ia " 1 an r th i"* like that which 
can do the trick, unfortunately, but there is 
another way commonly used on Machine Language 
programs using the PMODE4 screens. 

You've seen it, I'm sure. It's a color 
test. The PMODE4 screen pops up, with red or 
blue and a message telling the user to press 
reset if it is not red. When the user gets the 
computer to reset with the screen red, he 
presses < ENTER> . The following listing is one 
such color test routine. It was written with 
Disk EDTASM. This program was copyrighted, but 
I am giving you (and all other C0C0 Clipboard 
subscribers) permission to use it in your pro- 
grams provided you place a small note in them 
that John S. Rullo and I wrote the routine. 
Just add this code to your Assembly source 
(use your own ORG statement, and replace line 
500 with a JMP or BRA to the start of your 
Program). If you want, you can use it in a 
BASIC program by CLEAR 200.AH6FFF, loading it 
and executing it. I hope this cures the 
trouble. 



The Color Test Listing: 



00100 


♦COLOR 


TEST 


ROUTINE 


00110 


*BY ANDREW E 


. BARTELS 


00120 


*AND JOHN S. 


RULLO 


00130 


♦THANKS FOR 


HELPING, JOHN 


00140 


*COPYRI 


GHT (C) 1986 


00150 


POLCAT 


EQU 


$A000 


00160 


MODE 


EQU 


$FFC0 


00170 


VDGPIA 


EQU 


$FF22 


00180 


OFFSET 


EQU 


$FFC6 


00190 


STPGE1 


EQU 


$0E00 


00200 


ENPGE4 


EQU 


$2600 


00210 




ORG 


$7000 


00220 


START 


PULS 


X 


00230 




STX 


$200 


00240 




JSR 


RESET 


00250 


PMODE 


LDX 


IMODE 


00260 




STA 


,x 


00270 




STA 


3,X 



00280 




STA 


5 , X 


00290 




LDA 


VTKJPIA 


00300 




ORA 


# $F8 


00310 




STA 


VDGP1A 


00320 


PAGE 


LDX 


♦OFFSET 


00330 




STA 


1 ,X 


00340 




STA 


3,X 


00350 




STA 


5 ,X 


00360 




STA 


6 , X 


00370 




STA 


8 ,X 


00380 




STA 


10 , X 


00390 




STA 


12 ,X 


00400 


PCLS 


I. OX 


ISTPGEl 


00410 




LDD 


#$5555 


00420 


CLEAR 


STD 


,Xf) 


00430 




CMPX 


#ENPGE4 


00440 




RNE 


CLEAR 


00450 


KEY 


JSR 


[ POLCAT J 


00460 




BEQ 


KEY 


004 70 


FIXIT 


LDX 


JUMP 


00480 




STX 


1 1 68 


00490 




LDX 


$200 


00500 




TFR 


X , PC 


0051 0 


JUMP 


FDR 


$0 


00520 


RESET 


LDX 


$ 1 68 


00 530 




STX 


JUMP 


00540 




LDX 


#PMODK 


00550 




STX 


$168 


00560 




RTS 




00570 




END 


START 



f E VEN IF YOU DON'T HAVE A l 

- HARD DISK - 

I YOU CAN STILL SUPERCHARGE YOUR COCO 1,2, OR 3 WITH H 



YOU CAN STILL SUPERCHARGE YOUR COCO 1,2, OR 3 WITH 

RGB-DOS(HD) 

HERE ARE JUST SOME OE THE FEATURES OF RGB DOS(HD): 

4 FULLY COMPATIBLE WITH RS-DOS 

* WILL RUN TWO HARD DISK DRIVES 

* WILL AUTO-EXECUTE ANY PROGRAM 

* FULL SCREEN DIRECTORY DISPLAY 

* ELECTRONIC DISK LABELING 

* IMPROVED "COPY" COMMAND 

* "RUNM" COMMAND FOR M/L PROGRAMS 

* ...AND MUCH MUCH MORE! 
RGB DOS(HD) COMBINES ALL T HESE FEATURES WITH THE 

ABILITY TO RUN ANY SIZE HA 0 DISK DRIVE IN BASIC! 

DO YOUR COCO A FAVOR. ..SUPERCHARGE IT WITH RGB-DOS! 



I 
I 
I 
I 

1294 STILLWELL AVF 
KENMORE, NY 14217 



28 PIN ROM WITH USERS MANUAL... $74.95 

ALSO ASK ABOUT OUR PC/XT-TO-C0C0 KEYBOARD ADAPTER 
AND OUR FULLY SCSI COMPATIBLE HARD DISK INTERFACE 



COMPUTER 
SYSTEMS 



(716) 876-7538 



I 
I 
I 
I 

•si 



RAINBOW „ " ' - CoCo * 

«" ;;»o- tyntrdffsTVnciC 1, 2. * 3 

{Reviewed in Oct. 87 RAINBOW) Makes programming sensa- 
tional-looking graphics as easy as moving a joystick! Converts 
precision drawings into "DRAW" commands which can be stand- 
alone BASIC programs or merged into other programs Also 
includes "DEMO" and "PAINT" programs Requires a spring- 
centered joystick or touch pad 32k ECB tap* or dl»k $14.95 
? ENIGMA? 

Transform your computer into an ultra-secret code machine cap- 
able of enciphering and deciphering in over 12 million virtually 
unbreakable codes! (not simple substitution codes) Print hard 
copy or store & retrieve coded data on tape or disk Only the per- 
son who has the password can read it 1 32k ECB top* or dl»k $12.95 

Just answer the prompts & type your message; ' EZ WRITER" will 
put it into perfect letter form and send it to your DMP or DWP. 
Professional-quality. 1 to A page tetters every time! Do one letter 
or multiple copies for "personalized" mailings Saves letters and 
mailing lists. Even does labels. Menu -driven. Undoubtedly the 
EZ est letter writing system available! Free sample on request! 
32k ECB lap* or disk t19.9S i/aia/ I 

?ixFRt^Ptl»tEZScr«ndurnp BJKQL 
Print detailed pictures (large or small size) of your PMODE4 
graphics The 'EZ Screen Dump" works with all major dot math* 
printers and is fast and simple to use. See for yourself -send for 
tree examples of what it can do! 32k. ECB tape or disk only $14.95 

VCMY MASS 

This fascinating educational program features 2 of the cutest 
dancing teddy bears you've ever seen! Child uses joystick, 
mouse, or arrow keys to point to bear who holds the correct 
answer. Teacher or parent can SAVE many different kinds of short 
quizzes to use with this program 32k ECB tape or disk $ 19.95 
E.Z. FRIENDLY SOFTWARE MMM 

18 COOLIES AVE. • POUGHKEEPSIE. NY 12601 • (914) 485-9150 
(Add St 50 s/h lo all orders NY (esidenis add slate sales lax ) 



BASIC Hating for Color Test: 



10 * COLOR TEST ROUTINE 
20 1 BY ANDREW B. BARTELS 
30 'AND JOHN S. RULLO 
40 ' COPYRIGHT (C) 1986 
50 PCLEAR4 : CLEAR200 , AH6FFF 
60 FORX=*H7000 TO *H7056 : READA$ 
70 POKEX, VAL{ "&H"+A$ ) : NEXT 
80 EXECftH 7000 ' CALL RESET RTN 
90 PRINT"COLOR TEST DONE..." 
100 DATA 35,10 t BF,2,0,BD, 70.4A 
110 DATA 8E,FF,CO,A7,84,A7,03 
120 DATA A7 , 05 , B6 , FF, 22 , 8 A , F8 
130 DATA B7,FF,22,8E f FF f C6, A7 
140 DATA 1,A7,3,A7,5,A7,6,A7,8 
150 DATA A7,A,A7,C,8E,E,0,CC > 55 
160 DATA 55, ED, 81 , 8C, 26 , 0 , 26 , F9 
170 DATA AD,9F,A0,O,27,FA,BE,70 
180 DATA 48, BF, 1 ,68, BE, 2,0, IF 
190 DATA 1 5,0,0,BF, 1 ,68,BF, 70 
200 DATA 48,8E,70,8,BF,1 ,68,39 



Editors Note: We're very pleased to welcome 

Hosiy to our pages. Boisy is a recent high 

schol I graduate who comes to us with high 

recommendations from his teachers and several 
academic awards. 

"What in the world is a column on Disk 
BASIC doing in a serious-oriented magazine 
like CoCo Clipboard?" Some people have the 
misconception that Disk BASIC is just a mix- 
n-match of ROM code worth little value. They 
would rather stick with serious things like 
OS-9 and BASIC09 . I must agree on the basis 
that OS-9 and BAS1C09 are very serious, and 
bring a lot of power out of our CoCo, But let 
me ask, "How many people want to do serious 
things with their Color Computer, but not at 
the expense of learning OS-9 or BASIC09?" 

This column is not another merry-go-round 
tutorial on PMODE graphics or CIRCLE state- 
ments. The standard we are enforcing is rigid 
program structure and good programming design. 
Once we establish and learn these principles, 
we can proceed to tap into the seriousness of 
Disk BASIC. 

In this issue we will begin by intro- 
ducing you to the concept of "modular design." 
Modular design is a method used by programmers 
not only in BASIC, but in other high - level 
languages. Modular design gives us a foun- 
dation where we can start to build our 
st rue Lure -- the program. bet' a get a true 
blue definition on modular design in 
Pi tie-speak: 

MODULAR DESIGN - A structured programming 
concept where a program is divided into 
several parts (based on its overall content) 
in order for the programmer to more ef- 
feciently develop and test his/her work. 

Planning plays a vital role in modular 
design. Writing a program isn't something I 
just sit down and do. I've been known to drive 
great ideas to the grave by being in such a 
hurry to "try it out" on my CoCo that I became 
"lost in the code" and, out of frustration, 
never attempted to try again. I am sure we've 
all been in this scenaro: leaned over our CoCo 
at. 2 in the morning with a huge question mark 
dangling over our head, trying to figure out 
what we did wrong because we didn't take out 
time to plan. Good ideas die quickly without 
organization. 

Enough negative thought — let's begin 
our venture! First we will examine the "whys" 
of modular design. I've listed just a few 



below: 

- IT GIVES THE PROGRAMMER A "STANDARD" TO 
GO BY. You can come back 5 months later to an 
old program and make a patch or kill a bug be- 
cause of the organized structure you used 
throughout your work. 

- IT ENDORSES "PROGRAMMER FRE I NDL1 NESS" . 
Other programmers can modify portions of your 
program (that is if you want them to) easier 
and with less effort than searching through 
mounds of code scrolling on the screen. 

- IT GIVES YOUR PROGRAM A NEAT APPEARANCE. 
Your listings will be easier to follow while 
you study them and less hard to search through 
while debugging. 

IT CUTS DOWN ON LOST-TIME . You are more 
likely to recover sneaky bugs (and with leas 
time) if you use modular design. 

Sounds like programmer's heaven, doeBn't 
it? I tell you, using modular programming in 
your work REALLY makes a difference! I could 
go on, instance after instance, on how much 
time and effort 1 have saved by not hurriedly 
typing in something on my CoCo. It may take a 
little more effort than just Bitting down and 
typing, but it is definitely worth the end 
resu Its. 

There are as many methods of modular 
design as there are Rolls-Royces, but we will 
study only one -- the TOP-DOWN design. This 
particular modular design structure will fol- 
low the rules outlined below: 



REMARK 
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- Lines 0-99 will be the INITIALIZATION 
module. 

- Lines 100-39999 will be the MAIN PROGRAM 
module . 

- Lines 40000-49999 will be the ERROR TRAP 
moduJ e . 

- Lines 50000-59999 will be the SUBROUTINE 
module . 

- Lines 60000-63999 will be the DATA 
modul e . 

For this issue, we will study the 
INITIALIZATION, MAIN PROGRAM, and DATA mod- 
ules. We will cover the remaining modules in 
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The Wegert Report 

Steve Wegert 



With the continual crossover from the 
CoCo Forum into the world of OS9, forum 
members find themselves at a loss for a 
terminal program that allows for the proper 
handling of OS9 files. Right off the bat you 
have the problem of file format. Add to that 
the annoyances encountered with the inevitable 
XMODEM padding found at the end of most files 
transferred in that manner and improper 
handling of linefeeds and you're looking at 
quite a challenge when downloading files from 
CompuServe . 

Certainly you can use your favorite 
<fill~in-the blank> term program to download 
an OS9 file, use some type of conversion 
utility to convert it into the proper format, 
use yet another utility to strip the padding 
and linefeed trash but c'mon folks, let's get 
real. After the second pass through this 
forest of endurance you're fast checking your 
pulse and wonder about the 

al way s-pre sen t-yet-never- in- sight "better 
way " . 

OS9 FORUM ANNOUNCES IntroDisk (r) 

Much the same way Mikeyterm has become 
the 'standard' terminal program for the CoCo 
Forum, for a nominal charge to help defray 
media, printing and handling cost, the folks 
behind the OS9 forum now bring you "The OS9 
Forum's IntroDisk ( r ) " . 

Along with utilities to to assist with 
your OS9 file management and a few general 
help files on using the forum, on this disk is 

STERM " A Simple Terminal Program" written 

by Mark Griffith [76070,411. Full *C source 
is included. 

STERM is a child of the popular SMOD 
series of terminal emulators for the OS9 
Operating System originally developed by Carl 
Kreider and enhanced by Jim Jones. STERM 
includes the best features of it's parents 
while adding new features, such as 
CompuServe's new B-Plus protocol. The cost for 
the IntroDisk stuff (catchy name, eh?) is $10 
postpaid, cash, check, money order or 
Visa/Mastercard. 



NEW MENUS IN LIBRARIES 

With the coming of the new forum 
software, a better, more intuitive menu 
structure appeared and navigating the forum's 
libraries is a snap! 

Choosing item 3, LIBRARIES (Files) from 
the CoCo Forum main menu, you'll be presented 
with this panel: 

*The CoCo Forum* Libraries Menu 

Libraries Available: 

1 Reference Library 

2 Graphics 

3 Games 

4 Music 

5 Orchestra-90 

6 Telecommunications 

7 CoCo BBS Systems 

8 Application/Utility 

9 OpSystems/Languages 

10 Hardware/Technical 

11 CoCo 3 

12 The Soapbox 

13 Products / Reviews 

14 Private Classifieds 

15 Clubs / Newsletters 

The titles are self descri bingand should 
give you a good idea of what's contained 
behind doors 1 through 15. 

Choosing door number 1 , Reference 
Library, brings up another action panel to 
work with: 

♦The CoCo Forum* Library 1 
Reference Library 

1 BROWSE thru files 

2 DIRECTORY of files 

3 UPLOAD a new file 

4 DOWNLOAD a File 

5 LIBRARIES 



».„,,.„ .. „ , For a quick look at what files are 

Mailing address is: Golden Triangle available in this 'room' of the library 

Corporation asking for a DIRECTORY of files will list, in 

6029-A Plum Street last-in-first-out order, the file name, upload 

Watauga, TX 76148-3467 date, file size and number of access for each 

Phone orders (Visa/Mastercard only - No COD's) submission: 

may be called into 817/577-3351 Monday through 

Friday 1000-1900 Central, or Saturdays 

0900-1200. 
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Keywords: ASCII TEXT 
TRANSCRIPT CO CONFERENCE DENNIS 
SKALA PROGRAMMING 

USING osy 

This is the edited transcript of the CoCo 
Forum's Conference on June 11, 1 98fl , with 
guest Dennis Skala. The topic was "Programming 
and Using OS9". 

Press <CR> for next or type CHOICES ! 

Notice that the same information 
presented in a DIRECTORY is duplicated during 
a browse but additional facts such as the 
keywords and file description are now 
included. This bit of extra data should give 
you a good idea of what the file is about. 
It's always a good idea to look at the file 
description aB many times the submit tor will 
include instructions for its use as well as 
instruction files if needed. 

Thumping the <Enter> key will bring up 
the next selection of your search, asking for 

CHOICES presents the disposition panel: 
♦The CoCo Forum* Library Disposition 

1 READ this file 

2 DOWNLOAD this file 

3 RETURN to library menu 

Again, some very obvious choices. Option 
1 allows for online reading of a text file. 
Option 3 gets you out of trouble. Number 2 is 
the choice we need: 

Library Protocol Menu 

Transfer protocols available - 

1 XMODEM ( MODEM 7 ) protocol 

2 CompuServe ' B ' protocol 

3 CompuServe *A' protocol 

4 DC 4 / DC 2 CAPTURE protocol 

5 Keimif protocol 

6 CompuServe Quick 'B* protocol 
0 Abort transfer request 

CompuServe supports several transfer 
protocols. Most terminal programs will support 
one, if not several, of the ones listed above. 
It is recommended that a transfer protocol be 
used any time data integrity is an issue. If 
your terminal program supports it, B protocol 
is highly recommended for use on CompuServe. 
It's fast, transfers only what's in the file 
(no padding as found in XMODEM transfers) and 
fully supported by CompuServe. 

Uploading is just as simple. Choose the 
appropriate menu item from the Library panel 
and the system will prompt you for all the 
needed information: 

File name: TEST . TXT 
Library Protocol Menu 

Transfer protocols available - 

•]2 



1 XMODEM { MODEM 7 ) protocol 

2 CompuServe *B' protocol 

3 CompuServe 'A' protocol 

4 DC 4 /DC 2 CAPTURE protocol 

5 Kermit protocol 

6 CompuServe Quick ' B ' protocoL 

0 Abort transfer request 

Look familiar? It's very similar to the 
procedure to download files. Choose the 
protocol of your choice and the system takes 
over and issues prompts for the file name and 
file type. Specify accordingly. 

File name for your computer: mvdev.txt 

Transfer types available - 

1 A SCIT 

2 Binary 

3 Image 

4 Graphic: RLE 

5 Graphic :NAPLPS 

6 Graphic: GIF 

Enter choice t 

At this point, refer to the instructions 
that came with your terminal program on 
initiating file transfers. Some require a 
manual start while others are automatic. As 
always, should you have some confusion, leave 
a note to the SYSOP in the forum you're 
visiting. Include information on your systems 
set up (disk, tape, terminal program) and 
exactly what you're having difficulty with. 
Someone will get back to you. 

NEW SECTION LEADER ON COCO 

Recently, Dave Jenkins I 72756, 2213 J haB 
Join the staff 

of the CoCo Forum as BBS Section Leader. Dave 
holds a BS in Radio/TV and Journalism from 
Ball State University as well as an AS in 
Digital Electronics. Presently, he's employeed 
with WNIN TV/FM Channel 9 as an Engineer for 
the PBS employed in Evansville, IN. 

Dave also is the sysop for a local BBS 
celebrating it's one year anniversary. The 
Disk Bank runs 24 hours at 300/1200 baud and 
can be reached at (812) 422-4821. Expect to 
see Library 7 cleaned up post haste and some 
straight answers to your COBBS questions. 

CLIPBOARD CONFERENCES CONTINUE 

On the second Saturday of each month, Dan 
Robins and Ted Paul host the monthly 
"Clipboard Conference". Guest speakers are 
invited to speak on a variety of topics. 
Theses conference have generally lasted an 
hour and are kept moving by a moderator. 
Join us! Transcripts are made available in 
Library 1 of the CoCo Forum for those that 
can ' t attend . 

File Name Guest Topic 

2- 13CO.TXT Robins/Paul The CoCo and 
the Press 

3- I2CO.TXT a Caley/DeStefano/Paul The CoCo, 



der Poel 
Programming 
DMC 



Databases and Small Businessof 

4-09OO.TXT Bob van 

Telewriter- 128 
0611CO.TXT Dennis SkaLa 
and Using OS9 

0709CO.TXT David Wiens 

Controller, a Comparison 

STATE OF THE LIBRARIES 



Music and Graphics seem to be the heavy 
hitters on the CoCo Forum. Recently uploaded 
files include several digitized screens from 
harry Miller [ 70721 ,3351], CYCLPS . MCE , the 
cyclopg from the movie Krull, KAHN.MGE, from 
the Star Trek character of the same name, 
MORRIS. MGE, that all around Martial arts 
fun-guy, and PRSEUS.MCE, the warrior Perseus 
can be found in the Graphics Library. 

John Renfro Davis [74046,757] has been 
busy uploading a host of favorites to the 
ORCH-90 Library. BAGPIP.A85, is "Bagpipe 
Album" 13 bagpipe tunes, KODA.A85 

, , 'Rodachrome" by Paul Simon, MORGAN . A85 , 
Morning Morgantown" by Joni Mitchell, 
OLBNY.A85, "Only Living Boy In New York" by 
Paul Simon, JRTOLK.A85, "Songs from Middle 
Earth" by J.R.R. Tolkien and Donald Swann , 
DANGLE. A85 , "The Dangling Conversation" by 
Paul Simon, KQUEEN.A85, "Killer Queen" by 
Freddy Mercury of Queen, and MOTHER. A85, 
'Mother and Child Reunion" by Paul Simon, are 
now resting comfortably in Library 5 along 
with the efforts of Robbie Booth [70721,531], 
who brings us INTIME.A85, "Somewhere In Time" 
by John Barry and OVERB.A85, "Somewhere Over 
the Rainbow" 

In the Aplications Library, Fred McDonald 
[72667,35061 offers a series of files making 
up a Search utility that locateB GOTO ' s in 
BASIC code. Look for Applications, SEARCH . NOl , 
SEARCH. N02, and SEARCH. N03. 

Dennis Tomlinson [76515,2605] posts 
SUPERC.BAS, a disk cataloger. Specific to the 
CoCo 3 and in Library 1 1 we find Robert Pierce 
[76257,143] uploading DSKEDT.BIN. This is an 
early version of a subroutine used in the 
"D1SKBUSTER" Disk Utility. Kent Baumgardt 
[72207,2650] has uploaded three CoCoMax 3 
graphics for our viewing pleasure. Those 
without CoCoMax3 can use the CM3VUE utility 
for a looksee. X-29.CM3, The Grumman Aerospace 
aircraft with Forward Swept Wings, HELLFI.CM3, 
and acutaway diagram of the Hellfire 
laser-guided missile. 

Bob Van der Poel [76510,2203] helps make 
the switch from RSDOS with DUALDO. B0 9 , a short 
BASIC09 routine to create a RSDOS directory 
with 34 granules on an OS9 formatted disk. 
Kevin Darling [76703,4227] posts MAX9.AR. This 
graphics editor for L-II windows edits and 
creates VEF pictures. DEFEND. AR is the title 
screen from Amiga's Defender of the Crown 
game. Painstakingly edited to be viewed using 
the Wpix palette-switching program (or the 
latest Vefio program - hit spacebar). 

And you heard it first at the Chicago 
Rainbowfest. PLAY . AR is a sound player 
quickie. It can play Mac, Amiga whatever sound 
files that are digitized data. Use with the 
following files: 



DAVIDL.PLA/hinary 
[ 7 2 300 , 1433 ] 

CANTDO.SND/binary 
[ 73135, 1204] 

BEATLE . PLA/binary 
[72300,1433] 

BRIDGE. PLA/binary 
[76703,4255] 

DSRUFT. PLA/binary 
[ 76703,4255 ] 

FIRE. PLA/binary 
[76703,4255] 

GENQTR. PLA/binary 
[76703,4255] 

KIRK . PLA/binary 
[76703,4255] 

MYGOD. PLA/binary 
[76703,4255] 

PHASER. PLA/binary 
[76703,4255] 

SCOTTY . PLA/binary 
[76703,4255] 

SPOCK. PLA/binary 
[76703,4255] 

Be sure to check out the 
Announcement found in 
each forum for the most current information on 
the libraries. 



,i brary 



we are at the end of another 
a note on CompuServe and te 1 1 



And here 
column. Drop t 

me what you'd like to see in future articles. 
I can be reached either on the CoCo Forum or 
OS9 and via EasyPlex at 76703,4255. 



i VIPDisk-ZAP 

RAVED ABOUT IN THE 
APRIL 1983 "RAINBOW" 

Now you can retrieve lost data on any disk. 
VIP Disk-Zap is the ultimate repair utility lor 
repair of most disk errors. VIP Disk-Zap 
verifies diskettes, reads and writes any 
sector and lets you retrieve all types of 
bashed text files, BASIC and ML 
programs. VIP Disk-Zap includes a 50 
| page tutorial manual DISK $24.95 



VIP Terminal 

RATED BEST IN JANUARY 
1984 "RAINBOW" 

For your important communications needs 
you've got to go beyond software that only 
lets you chat. You need a smart terminal 
so that you can send and receive 
programs and messages and print them! 
The VIP Terminal features 32, 51, 64 or 85 
characters by 21 or 24 lines on the screen 
and has a 43K byte buffer to store 
information. DISK $29.95 



Turn the page for more VIP software! 
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What's In A Date 



Bob van der Poel 



No doubt you've all seen programs which 
print out calendars. For many of us, that's 
the only date related function we've ever seen 
on a computer. But dates are much more complex 
than a calendar printing program lets on. Be- 
fore continuing, see if you can answer these 
questions WITHOUT looking at a calendar: 

1. How many days are there between August 3, 

1988 and July 15, 1991? 

la. If I borrow $100.00 from you on January 1, 

1989 and pay it back to you on July 3, 1989 
and I've agreed to pay you simple interest on 
the loan at 12%, how much do I owe you? 

2. What date falls 120 days after June 3, 
1988? 

2a. If I borrow $100.00 from you on June 3, 
1988 and agree to pay you hack in 120 days, 
when is the loan due? 

Tough questions! Hopefully some BAS1O09 
subroutines will help with the answers. But 
before that, one more question: What date 
falls one month after March 31? Is it February 
28? I don't know either, but perhaps a logical 
reader will help us out by defining exactly 
what a month is and what we mean by "after." 

The key to the date subroutines presented 
this month is a concept known as the Julian 
day number. Simply defined, Julian day numbers 
are the number of days since a base date. Ac- 
cording to one of my sources, true Julian 
dates as used by astronomers are based on noon 
January 1, 4713 B.C. as day 0. 

The advantage of this scheme is that by 
converting two different dates to Julian day 
numbers we can now- do simple arithmetic on 
them. And, of course, we can then convert the 
new day number back to a date. 

Note: Julian day numbers have nothing to 
do with the Julian calendar. The Julian cal- 
endar was the predecessor to the Gregorian 
calendar we use today. This calendar was 
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adopted on September 14, 1752. Even though the 
routines will calculate dates prior to Sep- 
tember 14, 1752 these dates must be treated as 
"imaginary" since the current Gregorian cal- 
endar was not in use prior to this date. 

Presented at the end of this article are 
four conversion routines: 

Date_Jul converts a date to a Julian day 
number , 

Jul Data converts a Julian day number to a 
date, 

DayOfYear finds the day of year of a date, 
ZeiConv finds the day of week of a date. 

When typing in these programs do not type 
in the hexadecminal numbers in the first col- 
umn. These are not line numbers — they are the 
I -Code addresses of the program lines and are 
printed by BASIC09 when a listing is done. 
Also, be very careful that the correct number 
of parentheses are included. The math in the 
routines is very complex. Fortunately, we 
don't have to understand it to use it. 

Now let's return to our first question. 
The following program will prompt you for two 
dates. E Inspect converts both dates to a Julian 
day number; by subtracting Jl from J2 it is a 
trival matter to calculate the number of days 
between the two dates. 

PROCEDURE Elasped 

D I M Da te , Month , Year , Jl , J2 : REAL 

INPUT "Enter 1st date (dd,mm,yyyy) : 
'*, Date, Month, Year 

RUN Date Jul (Date .Month, Year, Jl ) 
INPUT "Enter 2nd date 
(dd, mia.yyyy ) : ", Dat e , Month , Year 
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Continued From 40 v 
When you write be sure to include your 
name, address, and phone number. We would like 
an idea that a CoCo 2 can utilize as well as a 
CoCo 3. We'll announce the idea and the 
program developed from it, in the next issue. 

0 '♦**** INITIALIZATION ****** 

1 ' 

2 » 

3 ' MODULAR DESIGN 

4 ' TUTOR PROGRAM 

5 ' BY: BOISY PITRE 

6 ' COCO CLIPBOARD 

7 'SEPTEMBER/OCTOBER 1988 ISSUE 

8 ' 

9 'NOTE: THIS PROGRAM IS A 

SUPPLEMENT TO THE 
ARTICLE, NOT A 
REPLACEMENT , 

10 ' *** SET-UP *** 
20 PCLEAR 1 

30 CLEAR 3000 

100 '***** MAIN PROGRAM *****' 
1 10 CLS 

115 '*** SET UP TITLE ***' 

120 PRINT® 20 1 , "MODULAR DESIGN 

130 PRINT® 234, "TUTOR PROGRAM 

140 PRINT© 29 7 , "BY : BOISY PITRE 

150 '* INTRODUCTORY SONG *' 

160 PLAY "03L7T4CDEEEEFEP5DDDDED 

P5CCCCDL3CL2D" 

170 '*** MESSAGE SCREEN ***' 
180 CLS 

190 PRINT A MESSAGE TO Y 

OU 

200 PRINT.-PRINT " ' MODULAR DESIGN 
TUTOR' IS THE SUPPLEMENT TO A 
N ARTICLE IN THE SEPT EMBER/OCTOB 
ER 1988 ISSUE OF COCO CLIPBOARD. 

WE SUGGEST YOU USE THIS PROGRA 
M IN CONJUNCTION WITH THE ARTICL 
E. FOR BACK ISSUE INFORMAT I 

ON, WRITE TO: " :PRINT 
210 FOR Y=1 TO 4: READ M$: PRINT T 
AB((31 LEN(M$))/2)M$:NEXT 
220 PLAY"L7T4O40EFFFFGFP5EEEEFEP 
5DDDDEL3DL2C 

230 FOR K=1 TO 5000:NEXT 
250 '*** TUTOR MENU ***' 
260 CLS 

270 PRINT TAB( 43 ) " TUTOR MENU" 
280 PRINT«136 T "1-INITIALIZATION 
290 PRINT«200, "2-MAIN PROGRAM" 
300 PRINT9264, "3-ERROR TRAP" 
310 PRINT9328, " 4-SUBROUTINES " 
320 PRINTS392, "5-DATA 
330 PRINT&456, "6-END PROGRAM 
350 '*** MENU INPUT ***' 
360 A$=INKEY$:IFA$=""THEN360 
370 ON VAL(A$) GOTO 1000,2000,30 
00,4000,5000, 6000 
380 GOTO 360 

1000 '*** CHOICE 1 ***' 

1001 ' INITIALIZATION' 
1010 CLS 

1020 PRINT " PART ONE-INITIAL 

IZATION 

1030 PRINT " LINE RANGE : 0 



104U PRINT :PRINI" THE INITIALIZ 
ATION MODULE IS MAKES UP THE FI 
RST 100 LINES OF YOUR PROGRAM. 
IT IS THE SET-UP PART OF YOUR PR 
OGRAM , COMMANDS SUCH AS pel ear, 
clear, AND dim SHOULD BE USED ' 
HERE . : PRINT : PRINT " YOUMAYALS 
O DEFINE STRING ANDNUMERI 

1999 PRINT9490, "PRESS A KEY-"--E 
XEC34442 :GOTO 250 

2000 '*** CHOICE 2 ***' 

2001 'MAIN PROGRAM' 
2010 CLS 

2020 PRINT" PART TWO-MAIN PR 

OGRAM 

2030 PRINT" LINE RANGE : 1 00- 3 

9999 

2040 PRINT 

2050 PRINT" THE MAIN PROGRAM MO 
DULE IS THELARGEST MODULE, COVER 
ING 39990 LINES. THIS MODULE C 
ONTAINS THE ' MEAT ' OF YOUR PROGRA 
M. PLACE ALL MENUS, CALCULATIO 
NS, AND SCREENS IN THIS MODUf 
E . " : PRINT 

2060 PRINT" FOR BETTER ORGANI7A 
TION, BREAKYOUR MAIN PROGRAM MOD 
ULE DOWN INTO SUB -MODULES . US 
E remark STATEMENTS LIBERALLY 
AND COMMENTAS MUCH AS POSSIBLE 

2999 PRINTG490, "PRESS A KEY-" --E 
XEC34442:GOTO 250 

3000 CLS:PRINT"NOT AVAI LABLE " - PR 
INT'PRESS A KEY:"; : EXEC34442 : GOT 
O 250 
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VIP Writer 

RATED "BEST" IN SEPT *88 "RAINBOW" 

VIP Writer has all the features of VIP Writer 
III described elsewhere in this magazine 
except the screen widths are 32, 51, 64 & 
85. Screen colors are black, green and 
white, double clock speed is not supported. 
Spooler is unavailable. Hard disk is not 
supported. Even so, VIP Writer is the 
BEST word processor for the CoCo 1 & 2! 
VIP Writer Includes VIP Speller AT NO 
ADDITIONAL COST. DISK $69.95 



VIP Database 

"ONE OF THE BEST" JULY 
1984 "RAINBOW" 

VIP Database has all the features of VIP 
Database III described elsewhere in this 
magazine except the screen widths are 51, 
64 & 85. Screen colors are black, green 
and white, double clock speed is not 
supported, Spooler is unavailable. Even so, 
VIP Database is the most complete 
database for the CoCo 1 & 2! DISK $49.95 



Turn the page fdf more VIP software! 
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U0E2 

oof; a 

00 EH 
00 EH 
0101 
0108 
0114 
0120 
0122 
0123 
0130 
0141 
0142 



0185 



PROCEDURE 
0000 
0001 



0038 
004 B 
004C 



(J084 
0085 



00C2 
00C3 
00C4 

O0D7 
00D8 
00 OF 
00E0 



m-MonUi 

IF m>2 THEN 

m=m-3 
ELSE 

y=y-l 
ENDIF 

e=INT( v/100) 
ya=INT(y-lUO*c) 

Jul ianDate= I NT! 146097. *c/4 ) 
+INTI 1461. *ya/4)+INT({ 153. * 
m+2 } /5 ) +BayOf Mon th+ 1 72 1 1 1 9 . 



Jui_Date 

{* BASIC09 Subroutine to 
convert a .ju i ian day 
number to 

(* a standard date. 

(* Based on an algorithm 
bv R. G. Tantzen, CACM 199 
pl-0 

(* usage: run .jul_date ( 
DayGTMonth. Month, Year, 
Jul ianDate) 



PAR AM DavOf Month, Month, 
Year, Jul ianDate: REAL 



DIM JD: REAL 
JD=JulianDate-1721119. 



00 KF 

00 F0 
0108 
0123 
0130 

0 1 3 1 

014 7 

0100 

0171 
0172 

0187 

01 9F 

0 1 B0 

oi in 

01C 1 
01 CE 
01 DA 
01DF 
0 1 EA 
01.E 6 
01F8 

PROCEDURE 
0000 
000] 

00 2 F 
0030 



0007 
0086 



Year-INTf (4*JD-1 ) /1 46097. ) 
J D~ 4*JD- 1- 146097 . *Year 
DayOf Mon th=I NT (JD/4 ) 

J D= I NT ( ( 4*DayOf Mon th+3 ) / 
1461) 

Da y 0 f M< m t h= 4 * Da vO Mo n t h + 3 - 

1461*JD 
DayOf Month- 1 NT ( ( DavOf Hon th+ 

4)/4) 

Mo n 1 1 1 = I NT ( ( 5 * Day 0 f Mon th~ 3 ) / 
153} 

DayOf Mon th=5*DayO fMonth-3- 

l53*Month 
DayO f Mon th= 1 NT ( ( DayOf Month* 

51/5) 

Year=100*Year+JD 
IF Month<l0 THEN 

Mont h=Month+3 
ELSE 

Month-Mont h-9 

Year=Year+ 1 
ENDIF 



ZulConv 

(* Calculate the day of 
week lor a given date. 

(* Based on a Fortran 
algorithm by J. Douglas 
Rober tson 

(* Published in CACM, 398- 
pl-rl 
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The GAMER'S CONNECTION! 

7 he ONLY magazine devoted solely to the CoCo gaming world 




l"he Gamer's Connection, a gnat new magazine devolcd solely to the Color 
Computer world is finally lime! 1'illtJ irom cover So cover with high quality 
programs, ankles, tutorials, advice, hits & lips, reviews and more reviews, this 
magazine is truly the besl and most inlormiitivc souicc of gaming AND non gaming 
information anywhere! Also luund inside are columns on BASIC programming, 
machine language iustnu Hum, progiaw design and so much more! The aspect we 
think you will like most alx.ti! us is the enjoyable way wc present the information 
lo you. While not in a childish or playlul way mind yon, but in one that you will 
enjoy. The ideal behind games is that they are lo be fun and relaxing, and we 
intend to keep I"he Gamer's Connection fun and very enjoyable lo read, and 
extremely informative as well. Right now yon can take advantage of our 
introductory special & save on our subscription rales •■> You can receive a full year 
(six issues) of The Garnet's Connection lor only $15. (X)!! This very limited offer is 
in effect only for the first 1000 people who take advantage of this special offer, so 
Act Now and start your subscription lo The Gamer's Connection, today! 



Please send your check or money order to 



The Garner's Connection 

P.O. Box 102 
Grafton, W] 53024 



If you are interested in more information about this new and most exciting magazine, please leel i;ee to write or use our 
customer service line 414/375-4635, between the hours of %m 5pm weekdays. 
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that thexr ,„dul„ „ rc not covered hire 
USING REMARKS 

BervaJfvIT 1 ^ ' y ° U are Bore • 

MARKS l« fi y r* f any ° ne hates to ™ e RE 
MARKS in their program, it ia T. Yet, it i s 

"aren't tbV'^r " f R ^RK 

Placment throughout your programs. It will 

much h^t| n , l0ng rUO and wUJ "ve you 

much hectic searching. 

THE INITIALIZATION MODULE - LINES 0-99 

The INITIALIZATION module i a u «ed to 
aet-up" or initialise your CoCc . This varys 

awISurS ?' ^ ° ther initialization 

strin* »nH keyW ? rda aie «■•<! here. Also, 
S^t X . r £ Un,er i C varia ble alignments can be 

' R Fhe thing to remember ia this? 

2 the Cl* EAR ?T C ° me flrSt ' foll °^ ^ 
e s) „L f statement, then 3) the DIM- 
° „ f arrays Variable assignments may 

then follow, along with any other set up roil- 

ro!S U>\Z7 U8e * a i U3ally pWe i-PorJ«t 
iuk&s in this area. Also, CoCo 3 owners should 
use^the ON BRK GOTO and ON ERR GOTO^Cteien ts 

THE MAIN PROGRAM MODULE - LINES 100-39999 
alway^he ffJ^l PROGRAM "^ule will aUoat 
" en " ' mputa, calculations, etc. J f you 

It is at this point where most "on-the 
iiSJ adS° gr r a Tr r f begln to ty P e - and I 

In the -iddle f fini 1 8h - It,B Hke ium t> in * 
in ine middle of a calculus class without 

MXi"! t ;5: fh rereqU i 8i i e9 - I,d «S"r »m« a 
right start than a head start. 

THE DATA MODULE — LINES 60000-63999 

The DATA module, by rule i * fh 0 i * 
»M. of the program! 1 1 contains information 
ine SaSj'i/fl. D JI\ atat — ts. Notice that 
BASIC ft!? hl « heat iine you can type a 

BASIC statement on. However, the 4000 lines 

luul:;: 8 ;: ra ;r than adequate ^ °™ 



First F «bly noticed in MODTUTOR that the 

first line of each module has the module name 

ihffi if lm • mod V;? 8 name for eas r locating 
while it is scrolling u P the screen. Other 

ill I H U f M ST Bnd the range for 

the module and you'll hit it every time.Also, 

first thiL habl \ K of documenting your program 
„»nfii J g 10 thG INITIALIZATION module. I 
the iJLf 6 name ° f the P ro «™». T name, 

the date it was created, and the version (when 
a version la applicable). X 

Well folks, that is it for this month r 

-etnod 8 r ttin 3 dOHn ^ BtUdyi "« the top-down 
ZtntTL ?f ?° dular Jeeign. Practice imple- 
menting it in your future programming pro- 
jects. An<1 don . t feel restrl J ted ra ;"i n « J™ 
numbers If you need » ore room then u e H 
Just make a mental note, or better yet, buy a 
legal pad and keep it next to your CoCo When 
you get to an important line or command, Jot 
down the line number. Keep track of RENUMs and 
DELs. If you follow the guidelines, I can 

:rre r efficient at «~ ^ 

we wn! nally ' Btartin 8 the issue after next, 
HiV I I pr ^ramming project based on the 

principles of modular design. We would like to 
have aome input from you, our readers, on a,° 
It* , r, SERI ° US ^ don't ^nt an 

H V ^ ° ,le t0 ° 8B,al1 - Give it some 

thought and drop a line to me c/o CoCo 
Clipboard Magazine, 3742 U.S. 20, Box 3 
Fredonia, NY 14063 ' 



VIP Calc 

I "MORE USEABLE FEATURES" 

FEBRUARY 1985 "RAINBOW" 

to? S C ,f ° T-r b ?* acc * ss to 8 cafcutaling and planning 
commands and then some. VIP Calc displays 32 51 64 or 85 
characters by 21 or 24 tines righ. on Ihe «crU VIP Calc alto* up 

addilion, VIP calc has multiple windows which allow you to 

ib uibii PRECISION • tog. functions • averag ng • aloetxaic 
L u " c l°r S ' ~lwnn«nd.'ow aseending or descending l(?RTs' 
| locate formulas or titles in cells ■ block move and replica . Jobal 
o local column width • limitless programmable functions ■ Works 
£ iM 1 ?!*' Emb « , >nter control codes for customized 
print ng Combine spreadsheet tables with VIP Writer documents lo 



VIP Speller 

INCLUDES 50,000 WORD DICTIONARY 
VIP Speller works with ANY ASCII file 
created by most popular word processors 
II automatically checks text tiles for words 
to be corrected, marked (or special 
attention or even added to the 50,000 
word Dictionary. You can even view" the 
word in context. Words can be added to or 
deleted from the dictionary or you can 
create your own dictionary! DISK $34 95 



Turn th e page fot more VIP software! 



RUN Date,. J u 1 ( Date , Mom Hi , Year, J 2 K 

PRINT "There are **; FIXU2-J1); Mays between 
these 2 dates." 

And as to the money 1 owe, it's just a matter 
of putting the number of days into the for- 
mula: 

Int=days/365 * rate * amount. 

Our '-"xt question involves eaXcu 1 at. iug n 
date X days from a given date. The program 
InXdays prompts for a date and the number of 
days. Again, Date^Jul is called to convert the 
date to a Julian day number; next the number 
of days are added; and the result is converted 
back to a date via Jul^Date. 

PROCEDURE InXdays 

DIM Date , Month , Year , Of f set , J I : REA1, 

INPUT "Enter the 'current' date ( dd , mm , yyyy ) : 
" , Date, Month .Year 

INPUT "Enter the number of days: ".Offset 

RUN Date_Jul( Date, Month, Year, J 1 ) 

RUN Jul_Date(Date,Month,Year,J] K)f fset) 

PRINT USING '"The new date is 
* ,i3, » , • , i3, ' , ' ,i5"; Date, Month, Year 

The next tool in our package of date 
algorithms is ZelCong (Zeller's Congruence). 
This routine will be most helpful for people 
wanting to write calendar programs, but it is 
also useful in data processing programs which 
need to know which day a particular date falls 
upon. For example, if you are setting up a 
loan you may not want the due date to fall on 
a Sunday. By way of an example the following 
little program displays the first date of the 
first Sunday in a given year. 

PROCEDURE Sunday 

DIM Date , Month .Year , DayOf Week : REAI, 
INPUT "Enter the year: ".Year Months 
FOR Date=l TO 31 

RUN ZelCong( Date , Mon th , Year , DayOf Week ) 
EX I TIF DayOfWeek=0 THEN 

PRINT "January " ; FIX (Date); " is the 1st 



Sunday i n "; Year 

FNDEXIT 
NEXT Date 

The numbers of the days returned by ZelCong 

are 0 to 6, where 0 is Sunday, 1 is Monday, 

etc. 

The last routine is DayOT Year. This cal- 
culates the day number of any date in a year 
with .January 1 being day 1 and December 31 
being day 365 (or in a leap year, 366). 

PROCEDURE Do fY test 

D i M Date , Mon th , Year , Day : REAL 

INPUT "Enter date ( dd , mm , yyyy ) : 
" , Date, Month, Year 

RUN Day Of Year { Date , Month , Year , Day ) 

PRINT "This is the "; FIX(Day); " day of the 

year, " 

I've tested all of the above routines 
with many different dates and found them to be 
very reliable. All of them properly compensate 
for leap years. Those of you interested in 
pursuing this concept further may be inter- 
ested in the following references; 

1. Collected Algorithms from CACM. In 
particular see 199 and 398. 

2. King, Gordon. "Julian Dates for 
Microcomputers." Dr. Dobb's Journal, Number 
80, June 1983. 

3. "Julian and Gregorian Calendars; Leap 
Year." The World Almanac & Book of Facts, 
Newspaper Enterprise Association, Inc. 

PROCEDURE bate Jul 

oooo 

00U 1 (* BnsicOH subroutine to 

convert a date to a .iul inn 
day number. 

00 10 

0011 (* Based on algorithm In 

R. G. Tant.zen, CA< M 1 '.i'J-pl- 
0 

007?; 

00/7 I* usage: run dale Jul 

( riayo fmonth. mon I h, year , 
ju I ianvalue J 

00B1 
00111! 

00B3 I 'ARAM DnyOf Month, Honl li, 

ear, Jul ianDate: REAL 

ooco 

00C7 DIM y,mjc,ya:REAL 

OO0A y=Vear 



VIP WRITER III VS THE COMPETITION 

VIP Writer has ALWAYS led foe pack with features and now VIP Writer III still leads the 
way I The chart below illustrates this fact. Telewriter 128 only gives you 48K for text 
Why is it called Telewriter 128? Word power 3 gives only 72KI ViP Writer III makes use 
ol over 106KI VIP Writer III is the ONLY CoCo 3 word processor worthy of ifs namel 



WORD PROCESSOR 
COMPARISON CHART 


CoCo3with128K 


VIP Writer TU 


Telewriter 128 


Word Power 3 


Text Storage .. 


Ovtfi 49,uu0 


48,066 


72,066 


Print spooler ^ 




WM 


NONE 


Total si6fa§e^ 


,106,000 


48,000 


72,000 


spelling Chetkc 


VlCSJijltiler 


NONE 


FREEWARE 


Screen Display ,,, 


32/40/64/80 


40/80 


80 



SCREEN DISPLAY OPTIONS 

As the chart above shows - VP Writer III offers more screen width options -all with 24 
lines and actual tower case letters. It uses the CoCo 3's hardware display and double clock 
speed and is VERY VERY FASTI You can choose fere and background colors from up to 
64 different hues. Color can be turned ON or OFF tor the best possible display using a 
color or monochrome monitor or TV set. VIP Writer III has a built in on-line context 
sensitive help facility which displays command usage in easy to read colored windows 

CUSTOMIZER & PRINTER INSIAIJ ER 

VIP Writer III comes with a configuration / printer installation program which lets you 
customize VIP Writer III to suit your own liking. You can set screen width and colors as well 
as margins and mora. You can also install your own printer and set interface type (serial, 
paralleior J8M), baud rate, line feeds, etc. Once done, you never have to enter these 
parameters againl VIP Writer III will load n' go with your custom configuration every timel 

TEXT FILE STORAGE 

VIP Writer III creates ASCII text files which are compatible with all other VIP Programs 
as well as other programs which use ASCII file format You can use VP Writer III to even 
create BASIC pfogramsl There is a 49K text buffer and disk or cassette file linking 
allowing virtually unlimited text space. VP Writer Hi works with up to four disk drives and 
lets you display disk directories and free space as well as rename or kill disk files. In 
addition VIP Writer III is 100% compatible with the RGB Computer Systems HARD DISK. 

EDITING FEATURES 

VIP Wnter III has a full featured screen editor which can be used to edit text with lines up 
to 240 characters long with or without automatic word wrap around. You can select 
type over mode or insert mode. There is even an COPS command to recall a cleared text 
buffer. Other editing features include: Type ahead • typamatic key repeat and key beep 



for (lawless text entry • end of line bell • full four way cursor control wifc scrolling • top 
of lextfile • bottom of taxttile • page up • page down • top of screen • bottom oi screen • 
beginning of line • end of line • toft one word • right one word • DELETE character, to 
beginning or end ol line, word to the left or right, or entire line • INSERT character or Kne 
• LOCATE and/or CHANGE or DELETE single or multiple occurrence using wildcards • 
BLOCK copy, move or delete with up to TEN simultaneous block manipulations • TAB key 
and programmable tab slops • word count • line restore • threer PROGRAMMABLE 
FUNCTIONS to perform tasks such as auto column creation and multiple copy printing 

TEXT FORMATTING 

VIP Writer III automatically formats your text lor you or allows you to format your text in 
any way you wish. You can change the lop, bottom, left or right margin and page length. 
You can set your text flush left, center or flush right. You can turn right hand 
justification on or off. You can have headers, footers, page numbers and TWO auxiliary 
ines which can appear on odd, even « al pages. You can also select the ine on which they 
appear! You can even change the line spacingt Parameters can be altered ANYWHERE 
within your text file! 

PREVIEW PRINT WINDOW 
VIP Writer III features an exclusive format window which allows you to preview your 
document BEFORE PRINTING IT I You are able to move up, down, left and right to see 
centered and justified text, margins, page breaks, orphan lines etc. 

PRINTING 

VIP Writer 111 prints TWICE as last as anv other CoCo word processor I ft supports most 
serial or parallel printers using JAM JFD-CP or Rainbow interface and gives you the 
ability to select baud rates Irom 110 to 19,200 You can imbed printer control codes 
anywhere in your text file EVEN WITHIN JUSTIFIED TEXTI VIP Writer III also has 
TWENTY programmable printer macros which allow you to easily control all of your 
printers capabilities such as bold, underline, italics and superscript using simple key 
strokes. Other features include: multiple copy printing • single sheet pause • line feeds. 

PRINT SPOOLING 

Save up to $150 on a print spooler because VIP Writer III has a built in print spooler with 
a 57,000 character butler which allows you to print one document WHILE you are editing 
another. You don't have to wail until your printer is done before starting another job! 

SPELLLING CHECKER 

VIP Writer III includes VIP Speller AT NO ADDITIONAL COSTI VIP Speller checks text 
for misspelled words and has a 50,000 word dictionary that can be added to or edited 

DOCUMENTATION 
VIP Writer III is supplied with a 125 page instruction manual which is 
well written and includes many examples. The manual has a tutorial and 
glossary of terms for the beginner as well as a complete index! VIP 

Writer III includes VIP Speller. DISK $79.95 

VIP Writer owners: Upgrade lo the VIP Writer tli Disk for 
$49.95 + $3 S/H. Sehd ORIGINAL disk and $52.95 total. 



VIP Database III 

VIP Database III features selectable screen displays of 40, 64 or 80 
characters by 24 lines with choice of 64 foreground, background, hilite 
and cursor colors for EASY DATA ENTRY. It uses the CoCo 3's 
hardware screen and double clock speed to be the FASTEST database 
available! VIP Database III will handle as many records as will fit on your 
disks and is structured in a simple and easy to understand menu system 
with full prompting for easy operation. Your data is stored in records 
of your own design. All files are fully indexed lor speed and efficiency. 
IN MEMORY SORT of records is LIGHTNING FAST and provides for 
easy listing of names, figures, addresses, etc., in ascending or 
descending alphabelical or numeric order. Records can be searched for 
specific entries using multiple search criteria. The built-in mail-merge 
lets you sort and print mailing lists, print form letters, address 
envelopes - the list is endless. The built-in MATH PACKAGE even 
performs arithmetic operations and updates other fields. VIP 
Database Hi also has a print spooler and report generator with 
unlimited print format capabilities including embeddable control codes 
for use with ALL printers. DISK $69.95 



VIP Database 6wtler$: Upgrade to the VIP Database III for 
$39.95 + $3 S/H. Send ORIGINAL disk and $42.95 totat 



VIP Library 

/W riter Database Enhanced 

The VIP Library A/VDE combines all six popular V!P application 
programs - VIP Database III, VIP Writer III, VIP Speller, VIP Calc, VIP 
Terminal and VIP Disk-ZAP - into one program on one disk! The 
program is called VIP Desktop. From the desktop you have instant 
access to word processing with a spelling checker always in attendance, 
data management with mail merge, spreadsheet financial analysis, 
telecommunications and disk maintenance. * DISK $169.95 



VIP Library owners: Upgrade to the VIP Library /WDE for 
$89.90* + $3 S/H. Send ORIGINAL disk and $92.90 total. 



* Future VIP Library upgrades available at reduced cost. 
AH products run under RSDOS and are riot copy protected. 

SID) ll^MMIISIES 

©(503) 663-2865 ^POB 1233 Gresham. OR 97030 

Please add $3 lor shipping. and handling Cuside conirwrul US add $4 S/H COO orders add an 
additional $2 25 Checks allow 3 weeks lor deivery. Al other orders are shipped tfi« same da*. 
Ttltwtitat iM k , »< W a 5§SC m Po»«r i It ludtmaS, cl Uaocm ESS U ~ 



********* ********* A** ************* *********** ******** ****** ******************* ************* 

KEN-TOJSI ELECTRONICS PRESENTS 

"REAL" S.C.S.I. INTERFACE -AND- THE DUAL RS-232 PAK 



r : ; 



HARD DRIVE INTERFACE 
$89 or $119(wlth RTC) 

Real Time Clock Ballery-backcd 

L.R. Tech Compalnblc 

Owl Dos Compilable 

ROB Dos Computable 

U Dos Computable 

OS-9 Computable 

28 pin ROM Socket 



DUAL COMM BOARD 
$74(Single) $89(Dual) 

Replaces RS-232 PA K 

2 - 6551 A.C.I. A. 's 

2 Independent RS-232 Chanels 

Jumpei selectable for up In 4 

(FOUR) Channels (with 2nd hoard) 

Ultra low power draw 

2H pin ROM Socket 



Build your Hard Drive (he RIGHT way will) a RI AL ST. S I. Interface. All our products are 
Mil. -Specification Qualify P.C. Boards and carry a lull 90 day Warranty. Both the Dual Comm and tin 
SC SI Interlace work directly with a Y CA BIT: or tlic Mulli Pak Interlace and are Made in the U.S.A. 

( ALL US FOR PRICES ON CUSTOM SYS II MS, HARD DRIVI S AND CABLES 



Terms: 

Check or M O. accepted (US Funds only) 

Please add $4.00 for S&II 

Phoru Orders are welcomed! 

OALI I-716-837-0U.H (M hr. order line) 

******* ********#****************AAAA**J.i.A.»AAA: 

C**Ca 

ilipboatti Ma gazine 



KEN -TOM 
ELECTRONICS 

ia / GRfcLN ACRtS RD. 
TOMAWANDA, MY 14 150 
************ ************** 
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